psyche-ai 11.5.2 → 11.5.3

package/README.md

@@ -87,6 +87,22 @@ Psyche 要解决的不可压缩问题只有一个：
 - `Psyche` 回答“我因此变成了什么”
 - `Thronglets` 回答“这个变化属于谁、谁能验证、谁能继续承认它”
 
+## `activePolicy` 只属于当前轮
+
+`Psyche` 现在可以消费来自宿主和 Thronglets 的 `activePolicy` / `currentGoal` / compliance-aware ambient priors，但它们都只是 runtime view，不是自我本体。
+
+- `activePolicy`：只来自显式来源，例如当前轮用户纠正、repo 本地明确指令、adapter 默认规则
+- `currentGoal`：只描述这一轮偏向 `explore / build / repair / settle` 的哪一个
+- method compliance：只作为当前轮解释和回应约束，不写进 Psyche 自身状态
+
+边界固定为：
+
+- 这些信号会影响当前轮的解释、距离感和行为偏置
+- 它们不会写进 `PsycheState`
+- `Psyche` 不会变成技术方法记忆库、repo 规则仓库或授权判断器
+
+一句话：`Psyche` 读取当前执行边界，但不把执行边界误当成“我是谁”。
+
 ## 可分离安装
 
 这两层默认就是可分离的，不应互相成为硬依赖。

package/dist/adapters/http.js

@@ -16,6 +16,7 @@
 // Zero dependencies — uses node:http only.
 // ============================================================
 import { createServer } from "node:http";
+import { normalizeActivePolicyRules, normalizeCurrentGoal, } from "../types.js";
 import { parseAmbientPriorsInput } from "../ambient-runtime.js";
 import { computeOverlay } from "../overlay.js";
 const VALID_WRITEBACK_SIGNALS = new Set([
@@ -96,11 +97,15 @@ export function createPsycheServer(engine, opts) {
                 const result = await engine.processInput(body.text ?? "", {
                     userId: body.userId,
                     ambientPriors: parseAmbientPriors(body.ambientPriors),
+                    currentGoal: normalizeCurrentGoal(body.currentGoal),
+                    activePolicy: normalizeActivePolicyRules(body.activePolicy),
                 });
                 json(res, 200, {
                     systemContext: result.systemContext,
                     dynamicContext: result.dynamicContext,
                     ambientPriors: result.ambientPriors ?? [],
+                    currentGoal: result.currentGoal ?? null,
+                    activePolicy: result.activePolicy ?? [],
                     ambientPriorContext: result.ambientPriorContext ?? null,
                     appraisal: result.appraisal,
                     legacyStimulus: result.legacyStimulus,

package/dist/adapters/mcp.d.ts

@@ -1,14 +1,14 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { PsycheEngine } from "../core.js";
 import { fetchAmbientPriorsFromThronglets, type ThrongletsAmbientRuntimeOptions } from "../ambient-runtime.js";
-import type { AmbientPriorView } from "../types.js";
+import { type ActivePolicyRule, type AmbientPriorView, type CurrentGoal } from "../types.js";
 export interface McpAmbientRuntimeOptions {
     mode?: "auto" | "off";
     thronglets?: ThrongletsAmbientRuntimeOptions;
     fetcher?: typeof fetchAmbientPriorsFromThronglets;
 }
 declare function getEngine(): Promise<PsycheEngine>;
-export declare function resolveRuntimeAmbientPriors(text: string, explicit?: AmbientPriorView[], opts?: McpAmbientRuntimeOptions): Promise<AmbientPriorView[] | undefined>;
+export declare function resolveRuntimeAmbientPriors(text: string, explicit?: AmbientPriorView[], currentGoal?: CurrentGoal, activePolicy?: ActivePolicyRule[], opts?: McpAmbientRuntimeOptions): Promise<AmbientPriorView[] | undefined>;
 declare const server: McpServer;
 export declare function runMcpServer(): Promise<void>;
 export { server, getEngine };

package/dist/adapters/mcp.js

@@ -32,6 +32,7 @@ import { z } from "zod";
 import { PsycheEngine } from "../core.js";
 import { fetchAmbientPriorsFromThronglets, resolveAmbientPriorsForTurn, } from "../ambient-runtime.js";
 import { MemoryStorageAdapter, FileStorageAdapter, resolveWorkspaceDir } from "../storage.js";
+import { CURRENT_GOALS } from "../types.js";
 import { getPackageVersion } from "../update.js";
 import { runDemo } from "../demo.js";
 const PACKAGE_VERSION = await getPackageVersion();
@@ -55,6 +56,7 @@ const DEFAULT_MCP_AMBIENT_OPTIONS = {
         space: process.env.THRONGLETS_SPACE ?? "psyche",
     },
 };
+const CURRENT_GOAL_SCHEMA = z.enum(CURRENT_GOALS);
 // ── Parse CLI args (--mbti, --name, --mode, --locale) ──────
 function parseCLIArgs() {
     const args = process.argv.slice(2);
@@ -124,11 +126,18 @@ async function getEngine() {
     await engine.initialize();
     return engine;
 }
-export async function resolveRuntimeAmbientPriors(text, explicit, opts = DEFAULT_MCP_AMBIENT_OPTIONS) {
+export async function resolveRuntimeAmbientPriors(text, explicit, currentGoal, activePolicy, opts = DEFAULT_MCP_AMBIENT_OPTIONS) {
+    const throngletsOptions = opts.thronglets || currentGoal || activePolicy?.length
+        ? {
+            ...(opts.thronglets ?? {}),
+            goal: currentGoal ?? opts.thronglets?.goal,
+            activePolicy: activePolicy ?? opts.thronglets?.activePolicy,
+        }
+        : undefined;
     return resolveAmbientPriorsForTurn(text, {
         explicit,
         enabled: opts.mode !== "off",
-        thronglets: opts.thronglets,
+        thronglets: throngletsOptions,
         fetcher: opts.fetcher ?? fetchAmbientPriorsFromThronglets,
     });
 }
@@ -191,15 +200,26 @@ server.tool("process_input", "Process user input through the emotional engine. R
         summary: z.string(),
         confidence: z.number().min(0).max(1),
         kind: z.enum(["failure-residue", "mixed-residue", "success-prior"]).optional(),
+        policyState: z.enum(["policy-conflict", "method-conflict", "stable-path"]).optional(),
+        goal: CURRENT_GOAL_SCHEMA.optional(),
         provider: z.string().optional(),
         refs: z.array(z.string()).optional(),
     })).optional().describe("Optional runtime ambient priors from the environment; consumed this turn only, not persisted as self-state"),
-}, async ({ text, userId, ambientPriors }) => {
+    currentGoal: CURRENT_GOAL_SCHEMA.optional().describe("Optional single current runtime goal for this turn"),
+    activePolicy: z.array(z.object({
+        id: z.string(),
+        strength: z.enum(["hard", "soft"]),
+        scope: z.enum(["task", "project"]),
+        summary: z.string(),
+    })).optional().describe("Optional explicit current-turn method policy view. Runtime-only; not persisted as self-state."),
+}, async ({ text, userId, ambientPriors, currentGoal, activePolicy }) => {
     const eng = await getEngine();
-    const resolvedAmbientPriors = await resolveRuntimeAmbientPriors(text, ambientPriors);
+    const resolvedAmbientPriors = await resolveRuntimeAmbientPriors(text, ambientPriors, currentGoal, activePolicy);
     const result = await eng.processInput(text, {
         userId,
         ambientPriors: resolvedAmbientPriors,
+        currentGoal,
+        activePolicy,
     });
     return {
         content: [{
@@ -208,6 +228,8 @@ server.tool("process_input", "Process user input through the emotional engine. R
                     systemContext: result.systemContext,
                     dynamicContext: result.dynamicContext,
                     ambientPriors: result.ambientPriors ?? [],
+                    activePolicy: result.activePolicy ?? [],
+                    currentGoal: result.currentGoal ?? null,
                     ambientPriorContext: result.ambientPriorContext ?? null,
                     appraisal: result.appraisal,
                     legacyStimulus: result.legacyStimulus,

package/dist/ambient-priors.d.ts

@@ -1,2 +1,2 @@
-import type { AmbientPriorView } from "./types.js";
+import { type AmbientPriorView } from "./types.js";
 export declare function normalizeAmbientPriors(priors: readonly AmbientPriorView[] | unknown, limit?: number): AmbientPriorView[];

package/dist/ambient-priors.js

@@ -1,8 +1,11 @@
+import { AMBIENT_POLICY_STATES, CURRENT_GOALS } from "./types.js";
 const AMBIENT_PRIOR_KINDS = new Set([
     "failure-residue",
     "mixed-residue",
     "success-prior",
 ]);
+const AMBIENT_POLICY_STATE_SET = new Set(AMBIENT_POLICY_STATES);
+const AMBIENT_PRIOR_GOALS = new Set(CURRENT_GOALS);
 export function normalizeAmbientPriors(priors, limit = 5) {
     if (!Array.isArray(priors))
         return [];
@@ -28,6 +31,14 @@ export function normalizeAmbientPriors(priors, limit = 5) {
             && AMBIENT_PRIOR_KINDS.has(rawKind)) {
             normalizedEntry.kind = rawKind;
         }
+        if (typeof record.policyState === "string"
+            && AMBIENT_POLICY_STATE_SET.has(record.policyState)) {
+            normalizedEntry.policyState = record.policyState;
+        }
+        if (typeof record.goal === "string"
+            && AMBIENT_PRIOR_GOALS.has(record.goal)) {
+            normalizedEntry.goal = record.goal;
+        }
         if (typeof record.provider === "string") {
             const provider = record.provider.trim();
             if (provider)

package/dist/ambient-runtime.d.ts

@@ -1,4 +1,4 @@
-import type { AmbientPriorView } from "./types.js";
+import type { ActivePolicyRule, AmbientPriorView, CurrentGoal } from "./types.js";
 interface CommandResult {
     ok: boolean;
     stdout: string;
@@ -9,6 +9,8 @@ export interface ThrongletsAmbientRuntimeOptions {
     binaryPath?: string;
     dataDir?: string;
     space?: string;
+    goal?: CurrentGoal;
+    activePolicy?: ActivePolicyRule[];
     limit?: number;
     timeoutMs?: number;
     runner?: CommandRunner;
@@ -16,6 +18,7 @@ export interface ThrongletsAmbientRuntimeOptions {
 export interface AmbientPriorResolutionOptions {
     explicit?: readonly AmbientPriorView[] | unknown;
     enabled?: boolean;
+    activePolicy?: ActivePolicyRule[];
     thronglets?: ThrongletsAmbientRuntimeOptions;
     fetcher?: typeof fetchAmbientPriorsFromThronglets;
 }

package/dist/ambient-runtime.js

@@ -2,10 +2,15 @@ import { spawn } from "node:child_process";
 import { normalizeAmbientPriors } from "./ambient-priors.js";
 const DEFAULT_AMBIENT_LIMIT = 3;
 const DEFAULT_TIMEOUT_MS = 800;
+const THRONGLETS_AMBIENT_SCHEMA_VERSION = "thronglets.ambient.v1";
 function parseAmbientPriorOutput(stdout) {
     if (!stdout.trim())
         return [];
     const parsed = JSON.parse(stdout);
+    if (typeof parsed.schema_version === "string"
+        && parsed.schema_version !== THRONGLETS_AMBIENT_SCHEMA_VERSION) {
+        return [];
+    }
     if (Array.isArray(parsed.priors)) {
         return normalizeAmbientPriors(parsed.priors);
     }
@@ -55,6 +60,7 @@ export async function fetchAmbientPriorsFromThronglets(text, opts = {}) {
     const binaryPath = opts.binaryPath ?? process.env.THRONGLETS_BIN ?? "thronglets";
     const dataDir = opts.dataDir ?? process.env.THRONGLETS_DATA_DIR;
     const space = opts.space ?? process.env.THRONGLETS_SPACE ?? "psyche";
+    const goal = opts.goal;
     const limit = Math.max(1, Math.min(5, opts.limit ?? DEFAULT_AMBIENT_LIMIT));
     const timeoutMs = Math.max(100, opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
     const runner = opts.runner ?? defaultRunner;
@@ -63,7 +69,13 @@ export async function fetchAmbientPriorsFromThronglets(text, opts = {}) {
         args.push("--data-dir", dataDir.trim());
     }
     args.push("ambient-priors", "--json");
-    const payload = JSON.stringify({ text: trimmed, space, limit });
+    const payload = JSON.stringify({
+        text: trimmed,
+        space,
+        goal,
+        limit,
+        active_policy: opts.activePolicy ?? [],
+    });
     try {
         const result = await runner(binaryPath, args, payload, timeoutMs);
         if (!result.ok)
@@ -85,6 +97,9 @@ export async function resolveAmbientPriorsForTurn(text, opts = {}) {
     if (opts.enabled === false)
         return undefined;
     const fetcher = opts.fetcher ?? fetchAmbientPriorsFromThronglets;
-    const priors = await fetcher(text, opts.thronglets);
+    const priors = await fetcher(text, {
+        ...(opts.thronglets ?? {}),
+        activePolicy: opts.activePolicy ?? opts.thronglets?.activePolicy,
+    });
     return priors.length > 0 ? priors : undefined;
 }

package/dist/cli.js

@@ -21,7 +21,7 @@
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import { parseArgs } from "node:util";
-import { readFile, writeFile, mkdir, access } from "node:fs/promises";
+import { readFile, writeFile, mkdir, access, rename, rm } from "node:fs/promises";
 import { loadState, saveState, decayAndSave, initializeState, mergeUpdates, generatePsycheMd, getRelationship, } from "./psyche-file.js";
 import { describeEmotionalState, getExpressionHint, detectEmotions } from "./chemistry.js";
 import { generateReport, formatReport, toGitHubIssueBody } from "./diagnostics.js";
@@ -606,6 +606,28 @@ async function fileExists(path) {
         return false;
     }
 }
+async function writeTextAtomic(path, content) {
+    const absPath = resolve(path);
+    const dir = resolve(absPath, "..");
+    await mkdir(dir, { recursive: true });
+    const base = absPath.split("/").pop() ?? "file";
+    const tmpPath = join(dir, `.${base}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`);
+    await writeFile(tmpPath, content, "utf-8");
+    try {
+        await rename(tmpPath, absPath);
+    }
+    catch (error) {
+        if (error?.code !== "EEXIST" && error?.code !== "EPERM") {
+            try {
+                await rm(tmpPath, { force: true });
+            }
+            catch { /* noop */ }
+            throw error;
+        }
+        await rm(absPath, { force: true });
+        await rename(tmpPath, absPath);
+    }
+}
 async function cmdSetup(opts) {
     const { name, mbti, locale, proxy, target, port, dryRun } = opts;
     const env = {};
@@ -676,8 +698,7 @@ async function cmdSetup(opts) {
                 actions++;
                 continue;
             }
-            await mkdir(dir, { recursive: true });
-            await writeFile(t.configPath, result.content, "utf-8");
+            await writeTextAtomic(t.configPath, result.content);
             console.log(`  ✓ ${t.name} (restart to activate)`);
             actions++;
             continue;
@@ -704,8 +725,7 @@ async function cmdSetup(opts) {
             actions++;
             continue;
         }
-        await mkdir(dir, { recursive: true });
-        await writeFile(t.configPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
+        await writeTextAtomic(t.configPath, JSON.stringify(cfg, null, 2) + "\n");
         console.log(`  ✓ ${t.name} (restart to activate)`);
         actions++;
     }
@@ -739,7 +759,7 @@ async function cmdSetup(opts) {
             if (rcFile) {
                 const rc = await fileExists(rcFile) ? await readFile(rcFile, "utf-8") : "";
                 if (!rc.includes("# psyche-proxy")) {
-                    await writeFile(rcFile, rc + (rc.endsWith("\n") ? "" : "\n") + exportLine + "\n", "utf-8");
+                    await writeTextAtomic(rcFile, rc + (rc.endsWith("\n") ? "" : "\n") + exportLine + "\n");
                     console.log(`  ✓ ${envVar} → ${proxyUrl} (${rcFile})`);
                 }
                 else {

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import type { AmbientPriorView, PsycheState, StimulusType, Locale, MBTIType, OutcomeScore, PsycheMode, PersonalityTraits, PolicyModifiers, ClassifierProvider, SubjectivityKernel, ResponseContract, GenerationControls, SessionBridgeState, ThrongletsExport, TurnObservability, WritebackCalibrationFeedback, WritebackSignalType, ExternalContinuityEnvelope, AppraisalAxes } from "./types.js";
+import type { ActivePolicyRule, AmbientPriorView, CurrentGoal, PsycheState, StimulusType, Locale, MBTIType, OutcomeScore, PsycheMode, PersonalityTraits, PolicyModifiers, ClassifierProvider, SubjectivityKernel, ResponseContract, GenerationControls, SessionBridgeState, ThrongletsExport, TurnObservability, WritebackCalibrationFeedback, WritebackSignalType, ExternalContinuityEnvelope, AppraisalAxes } from "./types.js";
 import type { StorageAdapter } from "./storage.js";
 import type { DiagnosticReport, SessionMetrics } from "./diagnostics.js";
 import type { ReplyEnvelope } from "./reply-envelope.js";
@@ -39,6 +39,10 @@ export interface ProcessInputResult {
     dynamicContext: string;
     /** Runtime-only environmental priors consumed this turn */
     ambientPriors?: AmbientPriorView[];
+    /** Runtime-only explicit method policy for the current task lineage */
+    activePolicy?: ActivePolicyRule[];
+    /** Optional current runtime goal carried through this turn only */
+    currentGoal?: CurrentGoal;
     /** Rendered environmental prior context injected into the turn, if any */
     ambientPriorContext?: string;
     /** Canonical host-facing subjective appraisal for this turn, null if no appraisal fired */
@@ -89,6 +93,8 @@ export interface ProcessInputResult {
 export interface ProcessInputOptions {
     userId?: string;
     ambientPriors?: AmbientPriorView[];
+    currentGoal?: CurrentGoal;
+    activePolicy?: ActivePolicyRule[];
 }
 export interface ProcessOutputResult {
     /** LLM output with <psyche_update> tags stripped */

package/dist/core.js

@@ -11,12 +11,13 @@
 //
 // Orchestrates: self-state, appraisal, prompt, profiles, guards, learning
 // ============================================================
+import { normalizeActivePolicyRules, normalizeCurrentGoal } from "./types.js";
 import { DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ENERGY_BUDGETS, DEFAULT_TRAIT_DRIFT, DEFAULT_SUBJECT_RESIDUE, DEFAULT_DYADIC_FIELD } from "./types.js";
 import { MemoryStorageAdapter } from "./storage.js";
 import { applyDecay, applyStimulus, applyContagion, clamp, describeEmotionalState } from "./chemistry.js";
 import { classifyLegacyStimulus, BuiltInClassifier, buildLLMClassifierPrompt, parseLLMClassification } from "./classify.js";
 import { perceive } from "./perceive.js";
-import { buildAmbientPriorContext, buildCompactContext, buildProtocolContext } from "./prompt.js";
+import { buildActivePolicyContext, buildAmbientPriorContext, buildCompactContext, buildProtocolContext } from "./prompt.js";
 import { getSensitivity, getBaseline, getDefaultSelfModel, traitsToBaseline } from "./profiles.js";
 import { isStimulusType } from "./guards.js";
 import { parsePsycheUpdate, mergeUpdates, updateAgreementStreak, pushSnapshot, compressSession, summarizeTurnSemantic, } from "./psyche-file.js";
@@ -460,7 +461,11 @@ export class PsycheEngine {
         }
         const writebackNote = formatWritebackFeedbackNote(writebackFeedback, locale);
         const ambientPriors = normalizeAmbientPriors(opts?.ambientPriors);
+        const activePolicy = normalizeActivePolicyRules(opts?.activePolicy) ?? [];
+        const currentGoal = normalizeCurrentGoal(opts?.currentGoal)
+            ?? ambientPriors.find((prior) => prior.goal)?.goal;
         const ambientPriorContext = buildAmbientPriorContext(ambientPriors, locale);
+        const activePolicyContext = buildActivePolicyContext(activePolicy, locale);
         const reflectiveTurn = runReflectiveTurnPhases({
             state,
             appraisalAxes,
@@ -494,6 +499,7 @@ export class PsycheEngine {
             userText: text || undefined,
             legacyStimulus: appliedStimulus,
             ambientPriors,
+            activePolicy,
             ambientPriorContext: ambientPriorContext || undefined,
             personalityIntensity: this.cfg.personalityIntensity,
             metacognitiveNote: reflectiveTurn.metacognitiveNote,
@@ -506,7 +512,9 @@ export class PsycheEngine {
             primarySystemsDescription: reflectiveTurn.primarySystemsDescription,
             subjectivityContext: derivedReplyEnvelope.subjectivityContext,
             responseContractContext: derivedReplyEnvelope.responseContractContext,
-            policyContext: derivedReplyEnvelope.policyContext || undefined,
+            policyContext: [activePolicyContext, derivedReplyEnvelope.policyContext]
+                .filter((value) => Boolean(value && value.trim().length > 0))
+                .join("\n") || undefined,
             sessionBridge,
         };
         const observability = buildTurnObservability(state, {
@@ -526,6 +534,8 @@ export class PsycheEngine {
             systemContext: "",
             dynamicContext: buildCompactContext(state, opts?.userId, promptRenderInputs),
             ambientPriors,
+            activePolicy,
+            currentGoal,
             ambientPriorContext: ambientPriorContext || undefined,
             appraisal: appraisalAxes,
             legacyStimulus: appliedStimulus,
@@ -542,7 +552,9 @@ export class PsycheEngine {
             externalContinuity,
             throngletsExports,
             observability,
-            policyContext: derivedReplyEnvelope.policyContext,
+            policyContext: [activePolicyContext, derivedReplyEnvelope.policyContext]
+                .filter((value) => Boolean(value && value.trim().length > 0))
+                .join("\n"),
         };
     }
     /**

package/dist/prompt.d.ts

@@ -1,10 +1,11 @@
-import type { AmbientPriorView, PsycheState, Locale, StateSnapshot, PsycheMode } from "./types.js";
+import type { ActivePolicyRule, AmbientPriorView, PsycheState, Locale, StateSnapshot, PsycheMode } from "./types.js";
 import type { AutonomicState } from "./autonomic.js";
 import type { ChannelType } from "./channels.js";
 export interface PromptRenderInputs {
     userText?: string;
     legacyStimulus?: string | null;
     ambientPriors?: AmbientPriorView[];
+    activePolicy?: ActivePolicyRule[];
     ambientPriorContext?: string;
     personalityIntensity?: number;
     channelType?: ChannelType;
@@ -23,6 +24,7 @@ export interface PromptRenderInputs {
     sessionBridge?: import("./types.js").SessionBridgeState | null;
 }
 export declare function buildAmbientPriorContext(priors: AmbientPriorView[] | undefined, locale: Locale): string;
+export declare function buildActivePolicyContext(activePolicy: ActivePolicyRule[] | undefined, locale: Locale): string;
 /**
  * Build the dynamic per-turn emotional context injected via before_prompt_build.
  *

package/dist/prompt.js

@@ -17,6 +17,8 @@ export function buildAmbientPriorContext(priors, locale) {
         summary: prior.summary.trim().replace(/\s+/g, " "),
         confidence: Math.max(0, Math.min(1, prior.confidence)),
         kind: prior.kind,
+        goal: prior.goal,
+        policyState: prior.policyState,
         provider: prior.provider?.trim(),
     }))
         .filter((prior) => prior.summary.length > 0)
@@ -39,6 +41,27 @@ export function buildAmbientPriorContext(priors, locale) {
         return "low confidence";
     };
     const title = locale === "zh" ? "环境先验" : "Ambient Prior";
+    const goal = normalized
+        .map((prior) => prior.goal)
+        .find((value) => Boolean(value));
+    const goalLabel = (value) => {
+        if (locale === "zh") {
+            if (value === "explore")
+                return "当前目标: 探索";
+            if (value === "build")
+                return "当前目标: 构建";
+            if (value === "repair")
+                return "当前目标: 修复";
+            return "当前目标: 结算";
+        }
+        if (value === "explore")
+            return "Current goal: explore";
+        if (value === "build")
+            return "Current goal: build";
+        if (value === "repair")
+            return "Current goal: repair";
+        return "Current goal: settle";
+    };
     const kindLabel = (kind) => {
         if (locale === "zh") {
             if (kind === "failure-residue")
@@ -58,12 +81,42 @@ export function buildAmbientPriorContext(priors, locale) {
         return "ambient";
     };
     const lines = normalized.map((prior) => {
+        const statePrefix = prior.policyState === "policy-conflict"
+            ? locale === "zh" ? "策略冲突 · " : "policy conflict · "
+            : prior.policyState === "method-conflict"
+                ? locale === "zh" ? "方法冲突 · " : "method conflict · "
+                : "";
         const source = prior.provider
             ? locale === "zh"
                 ? `${prior.provider}: `
                 : `${prior.provider}: `
             : "";
-        return `- ${kindLabel(prior.kind)} · ${source}${prior.summary} (${confidenceLabel(prior.confidence)})`;
+        return `- ${statePrefix}${kindLabel(prior.kind)} · ${source}${prior.summary} (${confidenceLabel(prior.confidence)})`;
+    });
+    const heading = goal ? `${title} · ${goalLabel(goal)}` : title;
+    const guidance = goal === "explore"
+        ? locale === "zh"
+            ? "- 将这些先验只当作软提示；保留可逆的、非共识的试探空间。"
+            : "- Treat these priors as soft hints only; preserve room for reversible non-consensus probes."
+        : "";
+    return `[${heading}]\n${guidance ? `${guidance}\n` : ""}${lines.join("\n")}`;
+}
+export function buildActivePolicyContext(activePolicy, locale) {
+    const rules = (activePolicy ?? [])
+        .map((rule) => ({
+        ...rule,
+        summary: rule.summary.trim().replace(/\s+/g, " "),
+    }))
+        .filter((rule) => rule.summary.length > 0)
+        .slice(0, 3);
+    if (rules.length === 0)
+        return "";
+    const title = locale === "zh" ? "当前方法约束" : "Active Method Policy";
+    const lines = rules.map((rule) => {
+        const strength = rule.strength === "hard"
+            ? (locale === "zh" ? "硬" : "hard")
+            : (locale === "zh" ? "软" : "soft");
+        return `- ${strength} · ${rule.summary}`;
     });
     return `[${title}]\n${lines.join("\n")}`;
 }

package/dist/types.d.ts

@@ -579,10 +579,28 @@ export interface SessionBridgeState {
  * It lets hosts surface sparse, task-conditioned priors without turning Psyche
  * into an operations memory store.
  */
+export declare const CURRENT_GOALS: readonly ["explore", "build", "repair", "settle"];
+export type CurrentGoal = (typeof CURRENT_GOALS)[number];
+export declare const ACTIVE_POLICY_STRENGTHS: readonly ["hard", "soft"];
+export type ActivePolicyStrength = (typeof ACTIVE_POLICY_STRENGTHS)[number];
+export declare const ACTIVE_POLICY_SCOPES: readonly ["task", "project"];
+export type ActivePolicyScope = (typeof ACTIVE_POLICY_SCOPES)[number];
+export declare const AMBIENT_POLICY_STATES: readonly ["policy-conflict", "method-conflict", "stable-path"];
+export type AmbientPolicyState = (typeof AMBIENT_POLICY_STATES)[number];
+export interface ActivePolicyRule {
+    id: string;
+    strength: ActivePolicyStrength;
+    scope: ActivePolicyScope;
+    summary: string;
+}
+export declare function normalizeCurrentGoal(value: unknown): CurrentGoal | undefined;
+export declare function normalizeActivePolicyRules(value: unknown, limit?: number): ActivePolicyRule[] | undefined;
 export interface AmbientPriorView {
     summary: string;
     confidence: number;
     kind?: "failure-residue" | "mixed-residue" | "success-prior";
+    policyState?: AmbientPolicyState;
+    goal?: CurrentGoal;
     provider?: string;
     refs?: string[];
 }

package/dist/types.js

@@ -209,6 +209,48 @@ export const DEFAULT_DYADIC_FIELD = {
     lastMove: "none",
     updatedAt: new Date(0).toISOString(),
 };
+/**
+ * AmbientPriorView — runtime-only environmental prior.
+ *
+ * This is a view projected into the current turn, not persistent self-state.
+ * It lets hosts surface sparse, task-conditioned priors without turning Psyche
+ * into an operations memory store.
+ */
+export const CURRENT_GOALS = ["explore", "build", "repair", "settle"];
+export const ACTIVE_POLICY_STRENGTHS = ["hard", "soft"];
+export const ACTIVE_POLICY_SCOPES = ["task", "project"];
+export const AMBIENT_POLICY_STATES = [
+    "policy-conflict",
+    "method-conflict",
+    "stable-path",
+];
+export function normalizeCurrentGoal(value) {
+    return typeof value === "string" && CURRENT_GOALS.includes(value)
+        ? value
+        : undefined;
+}
+export function normalizeActivePolicyRules(value, limit = 3) {
+    if (!Array.isArray(value))
+        return undefined;
+    const normalized = value
+        .filter((item) => !!item && typeof item === "object")
+        .map((item) => ({
+        id: typeof item.id === "string" ? item.id.trim() : "",
+        summary: typeof item.summary === "string" ? item.summary.trim().replace(/\s+/g, " ") : "",
+        strength: typeof item.strength === "string" && ACTIVE_POLICY_STRENGTHS.includes(item.strength)
+            ? item.strength
+            : undefined,
+        scope: typeof item.scope === "string" && ACTIVE_POLICY_SCOPES.includes(item.scope)
+            ? item.scope
+            : undefined,
+    }))
+        .filter((rule) => (rule.id.length > 0
+        && rule.summary.length > 0
+        && rule.strength !== undefined
+        && rule.scope !== undefined))
+        .slice(0, Math.max(1, limit));
+    return normalized.length > 0 ? normalized : undefined;
+}
 /** Default empty trait drift state */
 export const DEFAULT_TRAIT_DRIFT = {
     accumulators: {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "psyche-ai",
   "name": "Artificial Psyche",
   "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
-  "version": "11.5.2",
+  "version": "11.5.3",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "11.5.2",
+  "version": "11.5.3",
   "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
   "mcpName": "io.github.Shangri-la-0428/psyche-ai",
   "type": "module",