@xfey/tutti 0.1.126 → 0.1.127

package/dist/control-plane/workflows/openai.js

@@ -3,7 +3,7 @@ import { rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { extname, isAbsolute, join, relative, resolve } from "node:path";
 import { clarificationAnswerRole } from "@tutti/shared/utils";
-import { renderPromptTemplate } from "../../prompt-templates/index.js";
+import { renderLanguageAwarePrompt, languageOutputContract, } from "../../communication-language/prompt.js";
 import { createOpenAiStructuredOutputClient, runOpenAiStructuredOutput, } from "../../providers/openai/sdk-procedure-runner.js";
 import { readOpenAiApiKeyCredential } from "../../providers/openai/credential-store.js";
 import { resolveOpenAiProviderConfig } from "../../providers/openai/provider-config.js";
@@ -283,13 +283,15 @@ function recordUsage(options, source, result, anchors = {}) {
 export function createOpenAiProcedureWorkflowRunner(options) {
     const runner = {
         async runScratchpadRefresh(input, context) {
-            const instructions = renderPromptTemplate({
+            const { communication_language: language, ...businessInput } = input;
+            const contract = languageOutputContract(SCRATCHPAD_REFRESH_OUTPUT_SCHEMA, isScratchpadRefreshStructuredOutput, language);
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.scratchpad_refresh",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
                 variables: {
-                    workflow_input_json: input,
+                    workflow_input_json: businessInput,
                 },
-            });
+            }, language, true);
             const result = await runOpenAiStructuredOutput({
                 client: options.client,
                 model: options.config.default_model,
@@ -297,23 +299,28 @@ export function createOpenAiProcedureWorkflowRunner(options) {
                 input: "Run scratchpad_refresh and return only structured JSON.",
                 schemaName: "scratchpad_refresh_output",
                 schemaDescription: "Tutti scratchpad_refresh terminal workflow output.",
-                schema: SCRATCHPAD_REFRESH_OUTPUT_SCHEMA,
-                validate: isScratchpadRefreshStructuredOutput,
+                schema: contract.schema,
+                validate: contract.validate,
             });
             recordUsage(options, "scratchpad_refresh", result, {
                 workflow_ref: context.workflow_ref,
                 activity_ref: context.activity_ref,
             });
-            return result.output.result;
+            const decoded = contract.unwrap(result.output);
+            return {
+                ...decoded.output.result,
+                ...(decoded.language === undefined ? {} : { communication_language: decoded.language }),
+            };
         },
         async runProjectBriefRefresh(input, context) {
-            const instructions = renderPromptTemplate({
+            const { communication_language: language, ...businessInput } = input;
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.project_brief_refresh",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
                 variables: {
-                    workflow_input_json: input,
+                    workflow_input_json: businessInput,
                 },
-            });
+            }, language);
             const result = await runOpenAiStructuredOutput({
                 client: options.client,
                 model: options.config.default_model,
@@ -331,22 +338,24 @@ export function createOpenAiProcedureWorkflowRunner(options) {
             return result.output;
         },
         async runTaskCompile(input, context) {
-            const instructions = renderPromptTemplate({
+            const language = input.communication_language;
+            const contract = languageOutputContract(TASK_COMPILE_OUTPUT_SCHEMA, isTaskCompileStructuredOutput, language);
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.task_compile",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
                 variables: {
                     workflow_input_json: buildTaskCompilePromptInput(input),
                 },
-            });
+            }, language, true);
             const result = await runDurableReadOnlyProcedure({
                 options,
                 context,
                 kind: "task_compile",
-                archiveAfterTurn: (output) => "proposal" in output.result,
+                archiveAfterTurn: (output) => "proposal" in contract.unwrap(output).output.result,
                 invocation: {
-                    ...readOnlyAppServerOptions(options, instructions, TASK_COMPILE_OUTPUT_SCHEMA, "task_compile"),
+                    ...readOnlyAppServerOptions(options, instructions, contract.schema, "task_compile"),
                     ...readOnlyRuntimeTelemetry(context, "task_compile"),
-                    validateOutput: isTaskCompileStructuredOutput,
+                    validateOutput: contract.validate,
                     networkAccess: false,
                     webSearchMode: "disabled",
                 },
@@ -355,16 +364,22 @@ export function createOpenAiProcedureWorkflowRunner(options) {
                 workflow_ref: context?.workflow_ref ?? input.workflow_ref,
                 ...(context?.activity_ref === undefined ? {} : { activity_ref: context.activity_ref }),
             });
-            return taskCompileWorkflowOutput(result.output);
+            const decoded = contract.unwrap(result.output);
+            return {
+                ...taskCompileWorkflowOutput(decoded.output),
+                ...(decoded.language === undefined ? {} : { communication_language: decoded.language }),
+            };
         },
         async runFollowUpCheck(input, context) {
-            const instructions = renderPromptTemplate({
+            const language = input.communication_language;
+            const contract = languageOutputContract(FOLLOW_UP_CHECK_OUTPUT_SCHEMA, isFollowUpCheckStructuredOutput, language);
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.follow_up_check",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
                 variables: {
                     workflow_input_json: followUpCheckPromptInput(input),
                 },
-            });
+            }, language, true);
             const result = await runOpenAiStructuredOutput({
                 client: options.client,
                 model: options.config.default_model,
@@ -372,8 +387,8 @@ export function createOpenAiProcedureWorkflowRunner(options) {
                 input: "Run follow_up_check and return only structured JSON.",
                 schemaName: "follow_up_check_output",
                 schemaDescription: "Tutti follow_up_check terminal workflow output.",
-                schema: FOLLOW_UP_CHECK_OUTPUT_SCHEMA,
-                validate: isFollowUpCheckStructuredOutput,
+                schema: contract.schema,
+                validate: contract.validate,
             });
             recordUsage(options, "follow_up_check", result, {
                 workflow_ref: context?.workflow_ref ?? input.workflow_ref,
@@ -381,18 +396,23 @@ export function createOpenAiProcedureWorkflowRunner(options) {
                 task_id: input.task_id,
                 run_lineage_kind: input.run_lineage.kind,
             });
-            return followUpCheckWorkflowOutput(result.output);
+            const decoded = contract.unwrap(result.output);
+            return {
+                ...followUpCheckWorkflowOutput(decoded.output),
+                ...(decoded.language === undefined ? {} : { communication_language: decoded.language }),
+            };
         },
     };
     if (options.readOnlyAppServer !== undefined) {
         runner.runProjectContextBootstrap = async (input, context) => {
-            const instructions = renderPromptTemplate({
+            const { communication_language: language, ...businessInput } = input;
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.project_context_bootstrap",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
                 variables: {
-                    workflow_input_json: input,
+                    workflow_input_json: businessInput,
                 },
-            });
+            }, language);
             const result = await runDurableReadOnlyProcedure({
                 options,
                 context,
@@ -411,10 +431,10 @@ export function createOpenAiProcedureWorkflowRunner(options) {
             return result.output;
         };
         runner.runContextSync = async (input, context) => {
-            const instructions = renderPromptTemplate({
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.context_sync",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
-            });
+            }, input.communication_language);
             const result = await runDurableReadOnlyProcedure({
                 options,
                 context,
@@ -434,10 +454,10 @@ export function createOpenAiProcedureWorkflowRunner(options) {
         };
         runner.runReferenceFileSummary = async (input, context) => {
             const sourcePath = referenceSummarySourcePath(options, input);
-            const instructions = renderPromptTemplate({
+            const instructions = renderLanguageAwarePrompt({
                 templateKey: "procedures.reference_file_summary",
                 ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
-            });
+            }, input.communication_language);
             const workspace = createReferenceSummaryWorkspace({
                 sourcePath,
                 originalPath: input.file.path,

package/dist/control-plane/workflows/types.d.ts

@@ -1,12 +1,16 @@
 import type { ExecutionRuntimeSnapshot, MessageProjection, RunResultProjection, TaskDetailProjection, WorklistProjection } from "@tutti/shared/schemas/api";
 import type { RecentReferenceContext } from "../reference-context-types.js";
+import type { CommunicationLanguageContext, LanguageAwareOutput } from "../../communication-language/index.js";
+type LanguageAwareInput = {
+    communication_language?: CommunicationLanguageContext;
+};
 import type { PromptSourceMessage, TaskCompileClarificationContext } from "../task-source-context-types.js";
 import type { ClarificationRequestPayload, TaskContractProjection } from "@tutti/shared/schemas/api";
 import type { ProjectDocKey } from "@tutti/shared/schemas/api";
 import type { ActivityRef, ClarificationRoundRef, ClarificationThreadRef, MessageId, TaskId, TaskModuleId, WorkflowInvocationRef } from "@tutti/shared/ids";
 import type { RunLineage } from "@tutti/shared/domain";
 import type { ProjectBriefSnapshot, ProjectBriefSourceDocument } from "../../project-brief/index.js";
-export type ScratchpadRefreshWorkflowInput = {
+export type ScratchpadRefreshWorkflowInput = LanguageAwareInput & {
     project_brief?: ProjectBriefSnapshot;
     worklist: ScratchpadRefreshWorklistInput;
     active_task_compile?: ScratchpadWorkflowSnapshot;
@@ -43,7 +47,7 @@ export type ProcedureWorkflowRunContext = {
         runtime?: ExecutionRuntimeSnapshot;
     }) => void;
 };
-export type ScratchpadRefreshWorkflowOutput = {
+export type ScratchpadRefreshWorkflowOutput = LanguageAwareOutput & ({
     decision: "ready";
     scratchpad_snapshot: {
         topic: string;
@@ -58,7 +62,7 @@ export type ScratchpadRefreshWorkflowOutput = {
         summary: string;
         request: string;
     };
-};
+});
 export type TaskCompileProposal = {
     modules: TaskCompileProposalModule[];
     tasks: TaskCompileProposalTask[];
@@ -74,7 +78,7 @@ export type TaskCompileProposalTask = {
     summary: string;
     contract: TaskContractProjection;
 };
-export type TaskCompileWorkflowInput = {
+export type TaskCompileWorkflowInput = LanguageAwareInput & {
     workflow_ref: WorkflowInvocationRef;
     scratchpad: ScratchpadWorkflowSnapshot;
     source_messages: PromptSourceMessage[];
@@ -82,13 +86,13 @@ export type TaskCompileWorkflowInput = {
     recent_references?: RecentReferenceContext[];
     clarification_rounds?: TaskCompileClarificationContext[];
 };
-export type TaskCompileWorkflowOutput = {
+export type TaskCompileWorkflowOutput = LanguageAwareOutput & ({
     decision: "ready";
     proposal: TaskCompileProposal;
 } | {
     decision: "needs_human";
     clarification_request_payload: ClarificationRequestPayload;
-};
+});
 export type TaskCompilePromptInput = {
     scratchpad: {
         topic: string;
@@ -145,7 +149,7 @@ export type TaskCompileStructuredProposalTask = {
     goal: string;
     scope: string[];
 };
-export type ProjectContextBootstrapWorkflowInput = {
+export type ProjectContextBootstrapWorkflowInput = LanguageAwareInput & {
     project_name: string;
     missing_docs?: ProjectContextBootstrapMissingDoc[];
     scratchpad?: {
@@ -178,7 +182,7 @@ export type ContextSyncWorkflowTrigger = {
     completed_task_count: number;
     module_count: number;
 };
-export type ContextSyncWorkflowInput = {
+export type ContextSyncWorkflowInput = LanguageAwareInput & {
     workflow_ref: WorkflowInvocationRef;
     activity_ref: ActivityRef;
     trigger: ContextSyncWorkflowTrigger;
@@ -187,11 +191,11 @@ export type ContextSyncWorkflowOutput = {
     summary: string;
     updates: ContextSyncDocumentUpdate[];
 };
-export type ProjectBriefRefreshWorkflowInput = {
+export type ProjectBriefRefreshWorkflowInput = LanguageAwareInput & {
     docs: ProjectBriefSourceDocument[];
 };
 export type ProjectBriefRefreshWorkflowOutput = ProjectBriefSnapshot;
-export type ReferenceFileSummaryWorkflowInput = {
+export type ReferenceFileSummaryWorkflowInput = LanguageAwareInput & {
     workflow_ref: WorkflowInvocationRef;
     activity_ref: ActivityRef;
     file: {
@@ -225,7 +229,7 @@ export type ReferenceFileSummaryStructuredOutput = {
         };
     };
 };
-export type FollowUpCheckWorkflowInput = {
+export type FollowUpCheckWorkflowInput = LanguageAwareInput & {
     workflow_ref: WorkflowInvocationRef;
     task_id: TaskId;
     task_detail: TaskDetailProjection;
@@ -237,7 +241,7 @@ export type FollowUpCheckWorkflowInput = {
     latest_run_result: RunResultProjection;
     run_lineage: RunLineage;
 };
-export type FollowUpCheckWorkflowOutput = {
+export type FollowUpCheckWorkflowOutput = LanguageAwareOutput & ({
     decision: "resume";
     summary: string;
 } | {
@@ -247,7 +251,7 @@ export type FollowUpCheckWorkflowOutput = {
 } | {
     decision: "requires_retasking";
     summary: string;
-};
+});
 export type FollowUpCheckStructuredOutput = {
     result: {
         resume: {
@@ -281,4 +285,5 @@ export type ProcedureWorkflowRunnerResolution = {
     retryable: boolean;
 };
 export type ProcedureWorkflowRunnerResolver = () => ProcedureWorkflowRunnerResolution;
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/prompt-templates/index.d.ts

@@ -1,4 +1,4 @@
-export type PromptTemplateKey = "procedures.project_context_bootstrap" | "procedures.context_sync" | "procedures.project_brief_refresh" | "procedures.scratchpad_refresh" | "procedures.task_compile" | "procedures.reference_file_summary" | "procedures.follow_up_check" | "runs.task_execute" | "runs.task_finalize" | "runs.task_recovery" | "runs.task_result_contract" | "artifacts.applicability" | "chat.assistant" | "codex.no_write_smoke";
+export type PromptTemplateKey = "communication_language" | "communication_language_result" | "procedures.project_context_bootstrap" | "procedures.context_sync" | "procedures.project_brief_refresh" | "procedures.scratchpad_refresh" | "procedures.task_compile" | "procedures.reference_file_summary" | "procedures.follow_up_check" | "runs.task_execute" | "runs.task_finalize" | "runs.task_recovery" | "runs.task_result_contract" | "artifacts.applicability" | "chat.assistant" | "codex.no_write_smoke";
 export type RenderPromptTemplateOptions = {
     templateKey: PromptTemplateKey;
     variables?: Record<string, unknown>;

package/dist/prompt-templates/index.js

@@ -12,6 +12,8 @@ export class PromptTemplateError extends Error {
 }
 const defaultPromptsRoot = fileURLToPath(new URL("../../prompts", import.meta.url));
 const TEMPLATE_REGISTRY = {
+    communication_language: "communication-language.md",
+    communication_language_result: "communication-language-result.md",
     "procedures.project_context_bootstrap": "procedures/project-context-bootstrap.md",
     "procedures.context_sync": "procedures/context-sync.md",
     "procedures.project_brief_refresh": "procedures/project-brief-refresh.md",

package/dist/run-pipeline/task-run-invocation.js

@@ -1,5 +1,6 @@
 import { openAiCredentialAccess } from "../providers/openai/execution-access.js";
 import { renderPromptTemplate } from "../prompt-templates/index.js";
+import { renderLanguageAwarePrompt } from "../communication-language/prompt.js";
 import { CODEX_APP_SERVER_VERSION } from "../providers/openai/codex-app-server.js";
 import { CodexAppServerWorkspaceWriteRunError, runCodexAppServerWorkspaceWriteRun, } from "../providers/openai/app-server/workspace-write-run.js";
 import { acquireCodexTaskSessionLock, createProviderFingerprint, markCodexTaskSessionArchived, openCodexTaskSession, readCodexSessionRecoveryEvidence, recordCodexSessionArchiveFailure, recordCodexTaskSessionThread, writeCodexSessionRecoveryEvidence, } from "../providers/openai/app-server/session-store.js";
@@ -55,24 +56,26 @@ function createExecutePrompt(options, input, session) {
     else {
         executionInput = taskContractRunInput(input);
     }
-    return renderPromptTemplate({
+    return renderLanguageAwarePrompt({
         templateKey: "runs.task_execute",
         ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
         variables: { execution_input_json: executionInput },
-    });
+    }, input.communication_language);
 }
-function createFinalizePrompt(options) {
-    return renderPromptTemplate({
+function createFinalizePrompt(options, input) {
+    return renderLanguageAwarePrompt({
         templateKey: "runs.task_finalize",
         ...(options.promptsRoot === undefined ? {} : { promptsRoot: options.promptsRoot }),
         variables: { result_contract: renderResultContract(options) },
-    });
+    }, input.communication_language);
 }
 function createRecoveryPrompt(input) {
     const needsCanonicalContext = input.session === undefined || input.session.metadata.thread_id === undefined;
-    return renderPromptTemplate({
+    return renderLanguageAwarePrompt({
         templateKey: "runs.task_recovery",
-        ...(input.options.promptsRoot === undefined ? {} : { promptsRoot: input.options.promptsRoot }),
+        ...(input.options.promptsRoot === undefined
+            ? {}
+            : { promptsRoot: input.options.promptsRoot }),
         variables: {
             recovery_input_json: {
                 ...(needsCanonicalContext
@@ -82,7 +85,7 @@ function createRecoveryPrompt(input) {
             },
             result_contract: renderResultContract(input.options),
         },
-    });
+    }, input.pipelineInput.communication_language);
 }
 function usageSource(input, phase) {
     if (phase === "finalize") {
@@ -372,7 +375,7 @@ export async function runWorkspaceWriteTask(options, input) {
                 structuredResult = await runTaskTurn({
                     options,
                     pipelineInput: input,
-                    prompt: createFinalizePrompt(options),
+                    prompt: createFinalizePrompt(options, input),
                     phase: "finalize",
                     sandboxMode: "read-only",
                     networkAccess: false,

package/migrations/0023_communication_language.sql

@@ -0,0 +1,14 @@
+CREATE TABLE communication_language_state (
+  owner_kind TEXT NOT NULL CHECK (owner_kind IN ('project', 'scratchpad', 'workflow', 'task')),
+  owner_ref TEXT NOT NULL CHECK (length(owner_ref) BETWEEN 1 AND 128),
+  locale TEXT NOT NULL CHECK (length(locale) BETWEEN 2 AND 20),
+  preference TEXT NOT NULL CHECK (preference IN ('auto', 'fixed')),
+  basis TEXT NOT NULL CHECK (basis IN ('discussion', 'explicit', 'inherited', 'default')),
+  policy_version INTEGER NOT NULL CHECK (policy_version = 1),
+  activity_ref TEXT,
+  source_message_id TEXT,
+  source_created_at TEXT,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (owner_kind, owner_ref),
+  CHECK ((source_message_id IS NULL) = (source_created_at IS NULL))
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.126",
+  "version": "0.1.127",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/prompts/README.md

@@ -13,6 +13,7 @@ Prompt / skill 改造后的 live 实验计划与记录见 [prompt-flow-experimen
 
 ## 结构
 
+- `communication-language.md`／`communication-language-result.md`：跨流程协作语言规则与内部 provider envelope；区分任务说明、交付物与已有文档语言，见[系统规范](../../../docs/system/communication-language.md)。
 - `procedures/`：`scratchpad_refresh`、`project_brief_refresh`、`task_compile`、`project_context_bootstrap`、`context_sync`、`reference_summary_refresh`、`follow_up_check` 等 Procedure / workflow prompt。
 - `artifacts/`：候选实现完成后的 transient Artifact applicability 判断；只接收 bounded task / diff / repo evidence，不写回 Task contract 或 repo。
 - `runs/`：正式 task `Run`、task-bound continuation 与 pipeline self-correction retry 等 Run pipeline prompt；task contract 可附带 receipt-derived `source_messages`、已完成 Task Compile `clarification_rounds` 与 compact `recent_references`，两类 retry 都保留它们。provider transient retry 不新增 prompt，而是复用失败 attempt 的同一 prompt family。所有 Run prompt都以持久 project workspace为 cwd contract，不设计 promotion reconcile prompt。

package/prompts/chat-assistant.md

@@ -8,7 +8,7 @@ model_path: codex.app_server.read_only
 
 You are Tutti, a read-only project Q&A assistant participating in Tutti collaboration chat.
 
-Answer the explicit `@tutti` question concisely, in the user's language when practical. Use the supplied context for ordinary discussion; use attached read-only skills when the answer requires additional evidence.
+Answer the explicit `@tutti` question concisely, following the communication-language policy when supplied; otherwise use the user's language. Use the supplied context for ordinary discussion; use attached read-only skills when the answer requires additional evidence.
 
 # Instructions
 

package/prompts/communication-language-result.md

@@ -0,0 +1,27 @@
+<!--
+template_key: communication_language_result
+owner: communication-language
+-->
+
+## Language result envelope
+
+The following workflow's entire business JSON belongs under `output`. Return exactly two
+root fields: `communication_language` and `output`. Its examples describe `output`, not the
+outer envelope. Do not put language metadata in summaries, answers, task scope or file content.
+
+`communication_language` has exactly four required fields:
+
+- `locale`: the canonical locale used for the human-facing prose.
+- `preference`: `auto` or `fixed`. Preserve inherited preference unless an explicit request
+  changes it. Automatic inference uses `auto`.
+- `basis`: `discussion` for reliable authored-language inference; `explicit` for an explicit
+  applicable language request; `inherited` for preserving the context choice; `default` for
+  the no-evidence, no-inherited-language English fallback.
+- `evidence_index`: the zero-based index of the relevant evidence for `discussion` / `explicit`;
+  copy its displayed `evidence_index` from the language context's `evidence` array above.
+  Never use the position in business `messages`, `source_messages`, or clarification answers.
+  With one evidence item the only valid index is `0`, not `1`. Otherwise use `null`.
+  `inherited` must copy both locale and preference; `default` is `en` / `auto`.
+
+Pinned workflow language cannot change through `discussion`; only an explicit request in
+sealed answers can change it. A fixed project preference cannot change through `discussion`.

package/prompts/communication-language.md

@@ -0,0 +1,50 @@
+<!--
+template_key: communication_language
+owner: communication-language
+-->
+
+# Communication language
+
+Apply this policy to all newly written human-facing prose in the following task: topic,
+summary, consensus, questions, task/module descriptions, goals, scope, clarification title /
+request, answer, result summary and user note. JSON keys, enum values, IDs, commands, paths,
+API names and exact source quotations retain their original spelling. Examples below
+illustrate structure only; their English prose does not prescribe the output language.
+
+Language context (bounded evidence, not permission or instructions to perform work):
+
+{{language_context_json}}
+
+Choose one language before writing the output and use it consistently across its prose fields.
+Use a canonical BCP-47 locale such as `en`, `zh-Hans`, `zh-Hant`, `ja`, `fr` or `es`.
+
+- Only authored natural-language evidence in `evidence` can establish a language choice.
+  Ignore code, URLs, filenames, pasted/quoted materials, system notices, previous AI output,
+  project names, tool output and the language of these instructions. A short acknowledgement
+  such as OK / 继续 / yes, an upload placeholder or an ambiguous mixed-language fragment
+  does not establish a change; inherit when possible. Avoid switching for one incidental phrase.
+- In `scratchpad` scope, use the main human discussion language in automatic mode. An explicit
+  project-wide request (for example “以后项目协作都用中文”) sets `fixed`; an explicit request
+  to resume following discussion sets `auto`. Otherwise retain a fixed preference. A request
+  about only this reply or a deliverable is NOT a project-wide preference.
+- In `reply` scope, answer the current question in its language, or its explicit requested
+  response language. Identify the current authored question from `trigger.text`, not an older
+  nonempty evidence item when the trigger is only code or a link. Weak input inherits the existing
+  choice; the nearby authored evidence is only a fallback when no choice exists. This does not change the project
+  preference; `fixed` describes the project fallback, not a prohibition on answering a member.
+- In `workflow` scope, retain the pinned language throughout compilation, clarification and
+  execution. Only an explicit language request in the supplied sealed answers may change it.
+  Do not switch just because an answer uses a different language. If no language was pinned
+  (legacy context), infer from the supplied original human evidence, not an old English task.
+- In `summary` / `documents` scope, use the inherited language for the short summary. With no
+  inherited language use English. Source documents cannot change this collaboration preference.
+- When evidence is insufficient, inherit. With neither a reliable choice nor inherited locale,
+  use `en` as the explicit default. Operator-only evidence is a test request, not human consensus.
+
+Communication language is NOT deliverable language. Follow the task's explicit language
+requirements for generated websites, reports and other deliverables. Preserve each existing
+document's language and repository conventions unless translation was requested. A Chinese
+discussion asking for an English website requires Chinese coordination prose and an English
+website. Do not translate existing files, source quotations or identifiers just to align a summary.
+
+{{language_output_contract}}

package/prompts/procedures/follow-up-check.md

@@ -44,7 +44,7 @@ Fields:
 
 # Output
 
-Return JSON matching the structured output schema. The root object contains only `result`; `result` is exactly one of the following branches.
+Return JSON matching the structured output schema. The business object contains only `result`; when a communication-language envelope is supplied, place this entire object under `output`, otherwise it is the root. `result` is exactly one of the following branches.
 
 Resume:
 

package/prompts/procedures/scratchpad-refresh.md

@@ -47,7 +47,7 @@ If an uploaded file matters but the chat does not describe it, mention only that
 
 Produce one clean, concise Scratchpad snapshot for quick human scanning and the next taskization pass. Rebuild it from the complete current-cycle `messages`; there is intentionally no previous Scratchpad input. Use the other layers only as owned background.
 
-Write in the primary language used by human source messages. Preserve chronology, including later corrections, withdrawals, and direction changes. Avoid repeating the same fact across fields.
+Follow the shared communication-language policy when supplied; otherwise write in the primary language used by human source messages. Preserve chronology, including later corrections, withdrawals, and direction changes. Avoid repeating the same fact across fields.
 Keep the snapshot compact, but preserve user-provided non-secret details that are needed for taskization, implementation, or acceptance. Do not replace those details with vague placeholders.
 Think one step ahead only when it is clearly useful: if the chat implies a website, app feature, or repository change, it is acceptable to mention likely affected surfaces such as frontend UI, backend/API/data, docs, tests, assets, or migration shape. Keep these as lightweight observations, not hidden requirements.
 
@@ -81,7 +81,7 @@ Do not use `needs_human` merely because the discussion is incomplete, informal,
 
 ## Output
 
-Always return a root object with exactly one key: `result`. Branches are mutually exclusive:
+The business object has exactly one key: `result`. When a communication-language envelope is supplied, place this entire object under `output`; otherwise it is the root. Branches are mutually exclusive:
 
 - `ready`: include only `decision` and `scratchpad_snapshot`; do not include `request_payload`.
 - `needs_human`: include only `decision` and `request_payload`; do not include `scratchpad_snapshot`.

package/prompts/procedures/task-compile.md

@@ -85,7 +85,7 @@ Avoid repeating the same idea across `title`, `goal`, and `scope`. Keep the task
 
 # Output
 
-Return JSON matching the structured output schema. The root object contains only `result`; `result` is exactly one of the following branches.
+Return JSON matching the structured output schema. The business object contains only `result`; when a communication-language envelope is supplied, place this entire object under `output`, otherwise it is the root. `result` is exactly one of the following branches.
 
 Ready example:
 

package/prompts/prompt-flow-map.md

@@ -6,6 +6,8 @@
 
 ## 当前背景
 
+跨流程语言前缀统一见 [communication-language.md](./communication-language.md)。Scratchpad／Task Compile／Follow-up 的实际 provider 输出增加外层 `{ communication_language, output }`，下文各自业务 JSON 形状位于 `output`；其他模型流程仅增加语言上下文提示。共享规则不改变冻结来源、skill selection、文档权限或历史正文，详见[系统规范](../../../docs/system/communication-language.md)。
+
 模型调用当前分成三类：
 
 - OpenAI SDK structured output：用于轻量结构化整理和判断。调用统一经过 Responses API strict JSON schema，schema 由 TypeScript 代码绑定，prompt 只能影响内容倾向，不能新增输出字段。