dsh-vibe-math 2.5.0 → 2.7.0

package/prompt-corpus-persona/persona-corpus.md

@@ -5,8 +5,8 @@
 
 ## vibe-math-v2
 
-- 注册工具数：**25**
-- 斜杠命令 hint：`start|resume|pause|abort|status|report|mode <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|project [list|new <name>|<name>]|decisions|agents`
+- 注册工具数：**28**
+- 斜杠命令 hint：`start|resume|pause|abort|status|report|mode <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]`
 
 ### config.prefix
 
@@ -28,16 +28,27 @@ programmatically runs explorer (direction setting) → per-direction solvers (ag
 - vibe_math_status / vibe_math_report — read scheduler status / full progress report (report also writes Progress_Logs/report.json).
 - vibe_math_pause / vibe_math_abort — pause / abort (abort interrupts all children).
 - vibe_math_set_mode {mode: manual|auto} — switch manual / auto control.
-- vibe_math_set_params {...} — tune any parameter (see vibe_math_setup for the full schema; e.g. reportMode file|push|both, promoteValueThreshold, verdictMode flat|forced, formalVerify off|encourage|require).
+- vibe_math_set_params {...} — tune any parameter (see vibe_math_setup for the full schema; e.g. reportMode file|push|both, promoteValueThreshold, verdictMode flat|forced, formalVerify off|encourage|require, finalPaper true|false, paperFormat both|md|tex, paperLanguage zh|en, paperCompilePdf true|false, paperLatexCommand <engine>).
 - vibe_math_setup / vibe_math_save_settings / vibe_math_template — guided configuration / persist defaults / generate template.
 - vibe_math_new_project / vibe_math_set_project / vibe_math_list_projects — per-project folders.
 - vibe_math_list_decisions / vibe_math_decide {id, action: approve|reject|override, verdict?} — resolve manual decisions.
 - vibe_math_list_agents / vibe_math_message_agent / vibe_math_interrupt_agent — inspect / steer / interrupt subagents.
-- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib — Lean formal
-  verification (execute / archive / list the reuse library). The scheduler's child agents
-  use them too; they work in every mode.
-
-A /vibe slash command mirrors the main controls. Data lives under {{cwd}}/VibeMath/Projects/<project>/
+- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib / vibe_math_lean_read /
+  vibe_math_lean_job — Lean formal verification (execute / archive / list + read the reuse
+  library / inspect or wait for a background compile job). leanAsync=true (default) queues the
+  compile and returns a jobId; nothing counts as proved until that job settles ok (so "有把握"
+  is not the same as "已验证"). The scheduler's child agents use them too; they work in every
+  mode.
+
+- math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+- 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
+
+Final paper: strict termination writes Paper/<project>/{paper.md,paper.tex,paper.pdf,paper.meta.json,paper.log.md}
+automatically — a dedicated paper-writing child assembles the solved material (finalPaper=false disables only that
+automatic run). /vibe paper [lang=zh|en] [format=both|md|tex] [force] writes or rewrites it by hand. md/tex follow
+paperFormat; a PDF is produced only when a LaTeX engine is detected and paperCompilePdf is true.
+A /vibe slash command mirrors the main controls (/vibe start|resume|pause|abort|status|report|mode <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]).
+Data lives under {{cwd}}/VibeMath/Projects/<project>/
 (qs/qs.json, Propos/<分类>_Propos.json, Reliable/, Verified/, Verification_logs/, Progress_Logs/, VibeMath_State/)
 and survives restarts via vibe_math_resume.
 
@@ -69,7 +80,7 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     explicit, reasoned blocker record; the scheduler is never wedged by it).
   - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
     definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
-  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
+  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs / leanAsync / leanInitiative / leanSearchPaths / leanJobsMaxParallel are tunable as well
     (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
     reported as LEAN_NOT_FOUND and still lets the code be written and archived.
   - vibe_math_status / vibe_math_report show the mode, the per-object formal status and the
@@ -97,16 +108,27 @@ programmatically runs explorer (direction setting) → per-direction solvers (ag
 - vibe_math_status / vibe_math_report — read scheduler status / full progress report (report also writes Progress_Logs/report.json).
 - vibe_math_pause / vibe_math_abort — pause / abort (abort interrupts all children).
 - vibe_math_set_mode {mode: manual|auto} — switch manual / auto control.
-- vibe_math_set_params {...} — tune any parameter (see vibe_math_setup for the full schema; e.g. reportMode file|push|both, promoteValueThreshold, verdictMode flat|forced, formalVerify off|encourage|require).
+- vibe_math_set_params {...} — tune any parameter (see vibe_math_setup for the full schema; e.g. reportMode file|push|both, promoteValueThreshold, verdictMode flat|forced, formalVerify off|encourage|require, finalPaper true|false, paperFormat both|md|tex, paperLanguage zh|en, paperCompilePdf true|false, paperLatexCommand <engine>).
 - vibe_math_setup / vibe_math_save_settings / vibe_math_template — guided configuration / persist defaults / generate template.
 - vibe_math_new_project / vibe_math_set_project / vibe_math_list_projects — per-project folders.
 - vibe_math_list_decisions / vibe_math_decide {id, action: approve|reject|override, verdict?} — resolve manual decisions.
 - vibe_math_list_agents / vibe_math_message_agent / vibe_math_interrupt_agent — inspect / steer / interrupt subagents.
-- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib — Lean formal
-  verification (execute / archive / list the reuse library). The scheduler's child agents
-  use them too; they work in every mode.
-
-A /vibe slash command mirrors the main controls. Data lives under {{cwd}}/VibeMath/Projects/<project>/
+- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib / vibe_math_lean_read /
+  vibe_math_lean_job — Lean formal verification (execute / archive / list + read the reuse
+  library / inspect or wait for a background compile job). leanAsync=true (default) queues the
+  compile and returns a jobId; nothing counts as proved until that job settles ok (so "有把握"
+  is not the same as "已验证"). The scheduler's child agents use them too; they work in every
+  mode.
+
+- math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+- 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
+
+Final paper: strict termination writes Paper/<project>/{paper.md,paper.tex,paper.pdf,paper.meta.json,paper.log.md}
+automatically — a dedicated paper-writing child assembles the solved material (finalPaper=false disables only that
+automatic run). /vibe paper [lang=zh|en] [format=both|md|tex] [force] writes or rewrites it by hand. md/tex follow
+paperFormat; a PDF is produced only when a LaTeX engine is detected and paperCompilePdf is true.
+A /vibe slash command mirrors the main controls (/vibe start|resume|pause|abort|status|report|mode <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]).
+Data lives under {{cwd}}/VibeMath/Projects/<project>/
 (qs/qs.json, Propos/<分类>_Propos.json, Reliable/, Verified/, Verification_logs/, Progress_Logs/, VibeMath_State/)
 and survives restarts via vibe_math_resume.
 
@@ -138,7 +160,7 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     explicit, reasoned blocker record; the scheduler is never wedged by it).
   - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
     definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
-  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
+  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs / leanAsync / leanInitiative / leanSearchPaths / leanJobsMaxParallel are tunable as well
     (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
     reported as LEAN_NOT_FOUND and still lets the code be written and archived.
   - vibe_math_status / vibe_math_report show the mode, the per-object formal status and the
@@ -149,8 +171,8 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
 
 ## vibe-math-v3
 
-- 注册工具数：**33**
-- 斜杠命令 hint：`start [override]|resume [override]|pause|abort|status|report|mode <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|project [list|new <name>|<name>]|decisions|agents`
+- 注册工具数：**36**
+- 斜杠命令 hint：`start [override]|resume [override]|pause|abort|status|report|mode <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]`
 
 ### config.prefix
 
@@ -188,7 +210,10 @@ is experiential reference.
   plannerEnabled/plannerProvider/plannerModel/plannerPersona, planMinIntervalMs, plannerMaxFails,
   methodKeepIntervalMs/methodKeepEvery, methodAutoPromote, indexAutoRebuild, projectLockTimeoutMs,
   formalVerify/leanCommand/leanArgs/leanTimeoutMs — Lean 形式化验证（off = 默认不额外要求，
-  encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）).
+  encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）,
+  finalPaper/paperFormat/paperLanguage/paperCompilePdf/paperLatexCommand — 最终论文（收口时自动派遣
+  「论文撰写」子代理，把已收口的解法/命题/成果整理成 Paper/<project>/；finalPaper=false 只关自动触发，
+  /vibe paper 仍可手动触发）。
 - vibe_math_setup / vibe_math_save_settings / vibe_math_template — guided configuration / persist defaults / generate template.
 - vibe_math_plan {force?} — show queued plan / last plan, or force a planning round.
 - vibe_math_index — rebuild State/index.json from the Markdown knowledge base.
@@ -198,12 +223,18 @@ is experiential reference.
 - vibe_math_new_project / vibe_math_set_project / vibe_math_list_projects — per-project folders.
 - vibe_math_list_decisions / vibe_math_decide {id, action: approve|reject|override, verdict?} — resolve manual decisions.
 - vibe_math_list_agents / vibe_math_message_agent / vibe_math_interrupt_agent — inspect / steer / interrupt subagents.
-- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib — Lean formal
-  verification (execute / archive / list the reuse library). The scheduler's child agents
-  use them too; they work in every mode.
+- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib / vibe_math_lean_read /
+  vibe_math_lean_job — Lean formal verification (execute / archive / list + read the reuse
+  library / inspect or wait for a background compile job). leanAsync=true (default) queues the
+  compile and returns a jobId; nothing counts as proved until that job settles ok (so "有把握"
+  is not the same as "已验证"). The scheduler's child agents use them too; they work in every
+  mode.
+
+- math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+- 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
 
 A /vibe slash command mirrors the main controls (/vibe start [override]|resume [override]|pause|abort|status|report|mode
-<auto|manual>|setup|save|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|...).
+<auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]).
 Data survives restarts via vibe_math_resume.
 
 Key rules when reporting: a problem is "solved" when one of its 解法候选 entries reaches 概率 = 1
@@ -228,7 +259,7 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     explicit, reasoned blocker record; the scheduler is never wedged by it).
   - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
     definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
-  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
+  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs / leanAsync / leanInitiative / leanSearchPaths / leanJobsMaxParallel are tunable as well
     (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
     reported as LEAN_NOT_FOUND and still lets the code be written and archived.
   - vibe_math_status / vibe_math_report show the mode, the per-object formal status and the
@@ -273,7 +304,10 @@ is experiential reference.
   plannerEnabled/plannerProvider/plannerModel/plannerPersona, planMinIntervalMs, plannerMaxFails,
   methodKeepIntervalMs/methodKeepEvery, methodAutoPromote, indexAutoRebuild, projectLockTimeoutMs,
   formalVerify/leanCommand/leanArgs/leanTimeoutMs — Lean 形式化验证（off = 默认不额外要求，
-  encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）).
+  encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）,
+  finalPaper/paperFormat/paperLanguage/paperCompilePdf/paperLatexCommand — 最终论文（收口时自动派遣
+  「论文撰写」子代理，把已收口的解法/命题/成果整理成 Paper/<project>/；finalPaper=false 只关自动触发，
+  /vibe paper 仍可手动触发）。
 - vibe_math_setup / vibe_math_save_settings / vibe_math_template — guided configuration / persist defaults / generate template.
 - vibe_math_plan {force?} — show queued plan / last plan, or force a planning round.
 - vibe_math_index — rebuild State/index.json from the Markdown knowledge base.
@@ -283,12 +317,18 @@ is experiential reference.
 - vibe_math_new_project / vibe_math_set_project / vibe_math_list_projects — per-project folders.
 - vibe_math_list_decisions / vibe_math_decide {id, action: approve|reject|override, verdict?} — resolve manual decisions.
 - vibe_math_list_agents / vibe_math_message_agent / vibe_math_interrupt_agent — inspect / steer / interrupt subagents.
-- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib — Lean formal
-  verification (execute / archive / list the reuse library). The scheduler's child agents
-  use them too; they work in every mode.
+- vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib / vibe_math_lean_read /
+  vibe_math_lean_job — Lean formal verification (execute / archive / list + read the reuse
+  library / inspect or wait for a background compile job). leanAsync=true (default) queues the
+  compile and returns a jobId; nothing counts as proved until that job settles ok (so "有把握"
+  is not the same as "已验证"). The scheduler's child agents use them too; they work in every
+  mode.
+
+- math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+- 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
 
 A /vibe slash command mirrors the main controls (/vibe start [override]|resume [override]|pause|abort|status|report|mode
-<auto|manual>|setup|save|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|...).
+<auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]).
 Data survives restarts via vibe_math_resume.
 
 Key rules when reporting: a problem is "solved" when one of its 解法候选 entries reaches 概率 = 1
@@ -313,7 +353,7 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     explicit, reasoned blocker record; the scheduler is never wedged by it).
   - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
     definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
-  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
+  - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs / leanAsync / leanInitiative / leanSearchPaths / leanJobsMaxParallel are tunable as well
     (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
     reported as LEAN_NOT_FOUND and still lets the code be written and archived.
   - vibe_math_status / vibe_math_report show the mode, the per-object formal status and the
@@ -325,8 +365,8 @@ When the user asks about progress, call vibe_math_report and summarize in plain
 
 ## vibe-math-v4
 
-- 注册工具数：**32**
-- 斜杠命令 hint：`configure|start|resume|pause|abort|status|report|message <to|all> <content>|meeting|members|add|remove|set`
+- 注册工具数：**34**
+- 斜杠命令 hint：`configure|start|resume|pause|abort|status|report|message <to|all> <content>|meeting|paper [lang=zh|en] [format=md|tex|both] [editor=office|resident:<id>] [force]|members|add|remove|set`
 
 ### config.prefix
 
@@ -375,18 +415,27 @@ Data lives under {{cwd}}/VibeMath/Projects/<project>/:
 Main controls (recommended flow: configure FIRST, then start):
   - vibe_v4_configure {project?, problem?, params?} — create/configure the project (name, problem, params) WITHOUT starting a run; set everything here first.
   - vibe_v4_start {problem?, residentCount?, seedDirections?} — begin the run (spawn residents, brainstorm). If problem was configured, omit it.
-  - vibe_v4_set {residentCount, compactThreshold, compactAfterRounds, meetingKeepEvery, maxParallel, activityTimeoutMs, stallAutoMeetingMs, verdictMaxRounds, provider, model, residentPersona, toolAllow, toolDeny, formalVerify, leanCommand, leanArgs, leanTimeoutMs} — tune params (persisted to the settings file). provider/model override the residents' LLM route (empty = they inherit YOUR model/provider); toolAllow/toolDeny are per-resident tool permissions (empty = they inherit all tools). stallAutoMeetingMs is the stalled-group auto-sync-meeting threshold (分级保活 B). formalVerify (off|encourage|require, default off) enables Lean formal verification; leanCommand/leanArgs/leanTimeoutMs configure the toolchain.
+  - vibe_v4_set {residentCount, compactThreshold, compactAfterRounds, meetingKeepEvery, maxParallel, activityTimeoutMs, stallAutoMeetingMs, verdictMaxRounds, provider, model, residentPersona, toolAllow, toolDeny, formalVerify, leanCommand, leanArgs, leanTimeoutMs, leanAsync, leanInitiative, leanSearchPaths, leanJobsMaxParallel, finalPaper, paperFormat, paperLanguage, paperCompilePdf, paperEditor, paperLatexCommand} — tune params (persisted to the settings file). provider/model override the residents' LLM route (empty = they inherit YOUR model/provider); toolAllow/toolDeny are per-resident tool permissions (empty = they inherit all tools). stallAutoMeetingMs is the stalled-group auto-sync-meeting threshold (分级保活 B). formalVerify (off|encourage|require, default off) enables Lean formal verification; leanCommand/leanArgs/leanTimeoutMs configure the toolchain; leanAsync (true|false, default true) queues each compile as a background job (the tool returns {async:{jobId,state}} and the result lands later), leanInitiative (off|normal|eager, default normal) says how PROACTIVE the group is while working (independent of what formalVerify requires at voting time), leanSearchPaths adds extra compiler search roots (injected BEFORE the automatic VibeMath root), and leanJobsMaxParallel (default 1) caps concurrent compiles. The FINAL PAPER is tuned by finalPaper (true|false, default true), paperFormat (both|md|tex), paperLanguage (zh|en), paperCompilePdf (true|false), paperEditor (office|resident:<id>, default office = the human/assistant side finalises) and paperLatexCommand.
   - vibe_v4_resume / vibe_v4_pause / vibe_v4_abort / vibe_v4_status / vibe_v4_report.
   - vibe_v4_message {to|all, content} — inject a message to a resident (human/assistant intervention).
   - vibe_v4_meeting {agenda} — force a meeting.
   - vibe_v4_add_member {direction?} / vibe_v4_remove_member {id} — add / close a resident.
   - vibe_v4_list_members — list residents.
-  - vibe_v4_lean_run / vibe_v4_lean_archive / vibe_v4_lean_lib — Lean formal verification
-    (execute / archive / list the reuse library). Residents use them too; they work in every mode.
+  - vibe_v4_lean_run / vibe_v4_lean_archive / vibe_v4_lean_lib / vibe_v4_lean_read / vibe_v4_lean_job
+    — Lean formal verification (execute or ENQUEUE / archive / list the reuse library + background jobs /
+    read one archived library file verbatim / check or wait for a background job). Residents use them
+    too; they work in every mode.
   - vibe_v4_formal_report — human-readable Lean formal-verification mirror (mode, Lean-passed
+  - math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+  - 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
+  - Archive -> edit -> re-run: for mode:'code' the script original is at the receipt's scriptPath (Computation/<id>/script.<ext>) and you may open/edit it with your normal file tools; after editing, re-run it with mode:'file' to write a NEW receipt/attempt with a NEW scriptHash. **An old receipt is NOT evidence for edited code** - cite the receipt whose scriptHash matches the current code; the tool warns explicitly via scriptChanged / scriptChangedDuringRun.
     objects, recorded blockers, formalization TODO, library paths).
   - vibe_v4_prompts {which: brainstorm|normal|heartbeat|meeting|verify|coreRules, member?, target?, stage?} — read the exact prompt text a resident would receive (prompt auditing; prompt text is the product).
-A /v4 slash command mirrors the main controls (configure|start [problem]|resume|pause|abort|status|report|message <to|all> <content>|meeting|members|add|remove|set <k=v>...).
+A /v4 slash command mirrors the main controls (configure|start [problem]|resume|pause|abort|status|report|message <to|all> <content>|meeting|paper [lang=zh|en] [format=md|tex|both] [editor=office|resident:<id>] [force]|members|add|remove|set <k=v>...).
+Final paper: after the unanimous stop vote the run enters a PAPER phase — every resident writes their part, each
+cross-reviews at least one other part, and the paperEditor finalises (office = the human/assistant side, or one named
+resident); only then is the run marked complete. finalPaper=false skips the phase; /v4 paper [lang=zh|en]
+[format=md|tex|both] [editor=office|resident:<id>] [force] starts or re-runs it by hand.
 
 TRUST RULE: only Verified/ (and Propos/ entries marked 已验证·真/假) are absolutely
 trustworthy; everything else — unverified resident claims, Progress/, Method claims —
@@ -413,6 +462,15 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     explicit, reasoned blocker record; the run is never wedged by it).
   - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
     definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
+  - Reuse FIRST: call vibe_v4_lean_lib (and vibe_v4_lean_read for the verbatim text) BEFORE writing a new
+    definition; reuse an archived file with `import Formal.Lib.<name>` / `import Formal.Proved.<name>`
+    (the framework passes --search-path <VibeMath root>, so VibeMath is the module root).
+  - Choose WHAT to formalize with three criteria: (1) valuable or likely reusable, (2) rather key or
+    necessary, (3) you are confident in the statement — when you are NOT confident, record blocked
+    with the difficulty instead of hiding uncertainty behind a formalization.
+  - Compiles are BACKGROUND JOBS by default: a queued job is not a verification. An object only becomes
+    Lean-passed once its job settles green; the result is announced in the next prompt and visible via
+    vibe_v4_lean_lib.jobs / vibe_v4_lean_job (waitMs).
   - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
     (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
     reported as LEAN_NOT_FOUND and still lets the code be written and archived.
@@ -470,18 +528,27 @@ Data lives under {{cwd}}/VibeMath/Projects/<project>/:
 Main controls (recommended flow: configure FIRST, then start):
   - vibe_v4_configure {project?, problem?, params?} — create/configure the project (name, problem, params) WITHOUT starting a run; set everything here first.
   - vibe_v4_start {problem?, residentCount?, seedDirections?} — begin the run (spawn residents, brainstorm). If problem was configured, omit it.
-  - vibe_v4_set {residentCount, compactThreshold, compactAfterRounds, meetingKeepEvery, maxParallel, activityTimeoutMs, stallAutoMeetingMs, verdictMaxRounds, provider, model, residentPersona, toolAllow, toolDeny, formalVerify, leanCommand, leanArgs, leanTimeoutMs} — tune params (persisted to the settings file). provider/model override the residents' LLM route (empty = they inherit YOUR model/provider); toolAllow/toolDeny are per-resident tool permissions (empty = they inherit all tools). stallAutoMeetingMs is the stalled-group auto-sync-meeting threshold (分级保活 B). formalVerify (off|encourage|require, default off) enables Lean formal verification; leanCommand/leanArgs/leanTimeoutMs configure the toolchain.
+  - vibe_v4_set {residentCount, compactThreshold, compactAfterRounds, meetingKeepEvery, maxParallel, activityTimeoutMs, stallAutoMeetingMs, verdictMaxRounds, provider, model, residentPersona, toolAllow, toolDeny, formalVerify, leanCommand, leanArgs, leanTimeoutMs, leanAsync, leanInitiative, leanSearchPaths, leanJobsMaxParallel, finalPaper, paperFormat, paperLanguage, paperCompilePdf, paperEditor, paperLatexCommand} — tune params (persisted to the settings file). provider/model override the residents' LLM route (empty = they inherit YOUR model/provider); toolAllow/toolDeny are per-resident tool permissions (empty = they inherit all tools). stallAutoMeetingMs is the stalled-group auto-sync-meeting threshold (分级保活 B). formalVerify (off|encourage|require, default off) enables Lean formal verification; leanCommand/leanArgs/leanTimeoutMs configure the toolchain; leanAsync (true|false, default true) queues each compile as a background job (the tool returns {async:{jobId,state}} and the result lands later), leanInitiative (off|normal|eager, default normal) says how PROACTIVE the group is while working (independent of what formalVerify requires at voting time), leanSearchPaths adds extra compiler search roots (injected BEFORE the automatic VibeMath root), and leanJobsMaxParallel (default 1) caps concurrent compiles. The FINAL PAPER is tuned by finalPaper (true|false, default true), paperFormat (both|md|tex), paperLanguage (zh|en), paperCompilePdf (true|false), paperEditor (office|resident:<id>, default office = the human/assistant side finalises) and paperLatexCommand.
   - vibe_v4_resume / vibe_v4_pause / vibe_v4_abort / vibe_v4_status / vibe_v4_report.
   - vibe_v4_message {to|all, content} — inject a message to a resident (human/assistant intervention).
   - vibe_v4_meeting {agenda} — force a meeting.
   - vibe_v4_add_member {direction?} / vibe_v4_remove_member {id} — add / close a resident.
   - vibe_v4_list_members — list residents.
-  - vibe_v4_lean_run / vibe_v4_lean_archive / vibe_v4_lean_lib — Lean formal verification
-    (execute / archive / list the reuse library). Residents use them too; they work in every mode.
+  - vibe_v4_lean_run / vibe_v4_lean_archive / vibe_v4_lean_lib / vibe_v4_lean_read / vibe_v4_lean_job
+    — Lean formal verification (execute or ENQUEUE / archive / list the reuse library + background jobs /
+    read one archived library file verbatim / check or wait for a background job). Residents use them
+    too; they work in every mode.
   - vibe_v4_formal_report — human-readable Lean formal-verification mirror (mode, Lean-passed
+  - math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+  - 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
+  - Archive -> edit -> re-run: for mode:'code' the script original is at the receipt's scriptPath (Computation/<id>/script.<ext>) and you may open/edit it with your normal file tools; after editing, re-run it with mode:'file' to write a NEW receipt/attempt with a NEW scriptHash. **An old receipt is NOT evidence for edited code** - cite the receipt whose scriptHash matches the current code; the tool warns explicitly via scriptChanged / scriptChangedDuringRun.
     objects, recorded blockers, formalization TODO, library paths).
   - vibe_v4_prompts {which: brainstorm|normal|heartbeat|meeting|verify|coreRules, member?, target?, stage?} — read the exact prompt text a resident would receive (prompt auditing; prompt text is the product).
-A /v4 slash command mirrors the main controls (configure|start [problem]|resume|pause|abort|status|report|message <to|all> <content>|meeting|members|add|remove|set <k=v>...).
+A /v4 slash command mirrors the main controls (configure|start [problem]|resume|pause|abort|status|report|message <to|all> <content>|meeting|paper [lang=zh|en] [format=md|tex|both] [editor=office|resident:<id>] [force]|members|add|remove|set <k=v>...).
+Final paper: after the unanimous stop vote the run enters a PAPER phase — every resident writes their part, each
+cross-reviews at least one other part, and the paperEditor finalises (office = the human/assistant side, or one named
+resident); only then is the run marked complete. finalPaper=false skips the phase; /v4 paper [lang=zh|en]
+[format=md|tex|both] [editor=office|resident:<id>] [force] starts or re-runs it by hand.
 
 TRUST RULE: only Verified/ (and Propos/ entries marked 已验证·真/假) are absolutely
 trustworthy; everything else — unverified resident claims, Progress/, Method claims —
@@ -508,6 +575,15 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     explicit, reasoned blocker record; the run is never wedged by it).
   - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
     definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
+  - Reuse FIRST: call vibe_v4_lean_lib (and vibe_v4_lean_read for the verbatim text) BEFORE writing a new
+    definition; reuse an archived file with `import Formal.Lib.<name>` / `import Formal.Proved.<name>`
+    (the framework passes --search-path <VibeMath root>, so VibeMath is the module root).
+  - Choose WHAT to formalize with three criteria: (1) valuable or likely reusable, (2) rather key or
+    necessary, (3) you are confident in the statement — when you are NOT confident, record blocked
+    with the difficulty instead of hiding uncertainty behind a formalization.
+  - Compiles are BACKGROUND JOBS by default: a queued job is not a verification. An object only becomes
+    Lean-passed once its job settles green; the result is announced in the next prompt and visible via
+    vibe_v4_lean_lib.jobs / vibe_v4_lean_job (waitMs).
   - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
     (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
     reported as LEAN_NOT_FOUND and still lets the code be written and archived.
@@ -521,8 +597,8 @@ When the user asks about progress, call vibe_v4_report and summarize in plain la
 
 ## vibe-math-v5
 
-- 注册工具数：**35**
-- 斜杠命令 hint：`configure|start|resume|pause|stop|status|report|members|message|meeting|hire|fire|add|remove|set`
+- 注册工具数：**39**
+- 斜杠命令 hint：`configure|start|resume|pause|stop|status|report|members|message|meeting|hire|fire|add|remove|set|paper [lang=en] [format=tex] [editor=office] [force]`
 
 ### config.prefix
 
@@ -587,17 +663,22 @@ Data lives under {{cwd}}/VibeMath/Projects/<project>/Institutes/<institute>/:
 Main controls (recommended flow: configure FIRST, then start):
   - vibe_v5_configure {project?, institute?, problem?, params?} — create/configure the institute WITHOUT starting it.
   - vibe_v5_start {problem?, researcherCount?, academician?, seedDirections?} — found the institute (academician + researchers) and begin.
-  - vibe_v5_set {…} — tune params (persisted). provider/model override staff LLM routes (empty = inherit YOUR route); toolAllow/toolDeny restrict staff tools.
+  - vibe_v5_set {…} — tune params (persisted). provider/model override staff LLM routes (empty = inherit YOUR route); toolAllow/toolDeny restrict staff tools; finalPaper/paperFormat/paperLanguage/paperCompilePdf/paperEditor/paperLatexCommand tune the FINAL PAPER.
   - vibe_v5_pause / vibe_v5_resume / vibe_v5_stop / vibe_v5_status / vibe_v5_report.
   - vibe_v5_message {to|all, content} — relay a human message into the institute.
   - vibe_v5_meeting {agenda, kind} — convene a meeting.
   - vibe_v5_members — roster (office/employer/status/direction).
   - vibe_v5_hire / vibe_v5_fire — temp workers: hire one (office, academician or a permanent researcher) / dismiss one for real.
   - vibe_v5_add_researcher / vibe_v5_remove_researcher — OFFICE only: add or dismiss a PERMANENT researcher (the academician can only propose those).
-  - vibe_v5_lean_run / vibe_v5_lean_archive / vibe_v5_lean_lib — Lean formal
-    verification (execute / archive / list the reuse library). Members use them
-    too; they work in every mode.
-A /v5 slash command mirrors these (configure|start|resume|pause|stop|status|report|members|message|meeting|hire|fire|add|remove|set).
+  - vibe_v5_paper {lang?, format?, editor?, force?} — write the FINAL PAPER: the permanent staff write their own parts, cross-review each other, then the editor finalises. lang/format/editor override this one paper only.
+  - vibe_v5_finalize_paper {decision, note, conclusion?} — OFFICE only when paperEditor=office: consult the institute first (>=1 office message + >=1 meeting), then finalise and put the conclusion in note.
+  - vibe_v5_lean_run / vibe_v5_lean_archive / vibe_v5_lean_lib / vibe_v5_lean_read / vibe_v5_lean_job — Lean formal
+    verification (execute / archive / list the reuse library / read an archived file
+    verbatim / watch the background compile queue). Members use them too; they work in every mode.
+  - math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+  - 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
+  - Archive -> edit -> re-run: for mode:'code' the script original is at the receipt's scriptPath (Computation/<id>/script.<ext>) and you may open/edit it with your normal file tools; after editing, re-run it with mode:'file' to write a NEW receipt/attempt with a NEW scriptHash. **An old receipt is NOT evidence for edited code** - cite the receipt whose scriptHash matches the current code; the tool warns explicitly via scriptChanged / scriptChangedDuringRun.
+A /v5 slash command mirrors these (configure|start|resume|pause|stop|status|report|members|message|meeting|hire|fire|add|remove|set|paper).
 
 LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
   - 'off' (default, no extra requirement) | 'encourage' (members decide by
@@ -612,6 +693,19 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     reported as LEAN_NOT_FOUND, a host with no subprocess service as NO_SUBPROCESS
     (on a timeout the process is terminated first), and in every one of those cases the
     code can still be written down and archived.
+  - Daily eagerness is a SEPARATE knob: leanInitiative 'off' (no daily drive) |
+    'normal' (default; the reminder rides with formalVerify) | 'eager' (push valuable
+    small lemmas/propositions/definitions into the library even in ordinary rounds).
+  - Reuse first: check vibe_v5_lean_lib BEFORE writing a definition, reuse archived
+    content via `import Formal.Lib.<name>` / `import Formal.Proved.<name>` (the compile
+    gets `--search-path <VibeMath root>`, preceded by any leanSearchPaths), or copy the
+    exact text with vibe_v5_lean_read. Re-archiving identical content is de-duplicated.
+  - Compiles are ASYNC by default (leanAsync=true, leanJobsMaxParallel default 1):
+    vibe_v5_lean_run / vibe_v5_lean_archive enqueue and return at once; watch them with
+    vibe_v5_lean_job {jobId, waitMs} or vibe_v5_lean_lib.jobs, and NEVER treat an object
+    as passed before its job settles ok (exit 0, same content, same build context).
+  - Only formalize what you are confident about; when unsure record kind='blocked' with a
+    reason instead of dressing uncertainty up as a formalization.
   - vibe_v5_status / vibe_v5_report show the mode, per-object formal status and the
     formalization TODO. The framework never installs Lean and never judges fidelity.
 
@@ -686,17 +780,22 @@ Data lives under {{cwd}}/VibeMath/Projects/<project>/Institutes/<institute>/:
 Main controls (recommended flow: configure FIRST, then start):
   - vibe_v5_configure {project?, institute?, problem?, params?} — create/configure the institute WITHOUT starting it.
   - vibe_v5_start {problem?, researcherCount?, academician?, seedDirections?} — found the institute (academician + researchers) and begin.
-  - vibe_v5_set {…} — tune params (persisted). provider/model override staff LLM routes (empty = inherit YOUR route); toolAllow/toolDeny restrict staff tools.
+  - vibe_v5_set {…} — tune params (persisted). provider/model override staff LLM routes (empty = inherit YOUR route); toolAllow/toolDeny restrict staff tools; finalPaper/paperFormat/paperLanguage/paperCompilePdf/paperEditor/paperLatexCommand tune the FINAL PAPER.
   - vibe_v5_pause / vibe_v5_resume / vibe_v5_stop / vibe_v5_status / vibe_v5_report.
   - vibe_v5_message {to|all, content} — relay a human message into the institute.
   - vibe_v5_meeting {agenda, kind} — convene a meeting.
   - vibe_v5_members — roster (office/employer/status/direction).
   - vibe_v5_hire / vibe_v5_fire — temp workers: hire one (office, academician or a permanent researcher) / dismiss one for real.
   - vibe_v5_add_researcher / vibe_v5_remove_researcher — OFFICE only: add or dismiss a PERMANENT researcher (the academician can only propose those).
-  - vibe_v5_lean_run / vibe_v5_lean_archive / vibe_v5_lean_lib — Lean formal
-    verification (execute / archive / list the reuse library). Members use them
-    too; they work in every mode.
-A /v5 slash command mirrors these (configure|start|resume|pause|stop|status|report|members|message|meeting|hire|fire|add|remove|set).
+  - vibe_v5_paper {lang?, format?, editor?, force?} — write the FINAL PAPER: the permanent staff write their own parts, cross-review each other, then the editor finalises. lang/format/editor override this one paper only.
+  - vibe_v5_finalize_paper {decision, note, conclusion?} — OFFICE only when paperEditor=office: consult the institute first (>=1 office message + >=1 meeting), then finalise and put the conclusion in note.
+  - vibe_v5_lean_run / vibe_v5_lean_archive / vibe_v5_lean_lib / vibe_v5_lean_read / vibe_v5_lean_job — Lean formal
+    verification (execute / archive / list the reuse library / read an archived file
+    verbatim / watch the background compile queue). Members use them too; they work in every mode.
+  - math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+  - 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
+  - Archive -> edit -> re-run: for mode:'code' the script original is at the receipt's scriptPath (Computation/<id>/script.<ext>) and you may open/edit it with your normal file tools; after editing, re-run it with mode:'file' to write a NEW receipt/attempt with a NEW scriptHash. **An old receipt is NOT evidence for edited code** - cite the receipt whose scriptHash matches the current code; the tool warns explicitly via scriptChanged / scriptChangedDuringRun.
+A /v5 slash command mirrors these (configure|start|resume|pause|stop|status|report|members|message|meeting|hire|fire|add|remove|set|paper).
 
 LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
   - 'off' (default, no extra requirement) | 'encourage' (members decide by
@@ -711,6 +810,19 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
     reported as LEAN_NOT_FOUND, a host with no subprocess service as NO_SUBPROCESS
     (on a timeout the process is terminated first), and in every one of those cases the
     code can still be written down and archived.
+  - Daily eagerness is a SEPARATE knob: leanInitiative 'off' (no daily drive) |
+    'normal' (default; the reminder rides with formalVerify) | 'eager' (push valuable
+    small lemmas/propositions/definitions into the library even in ordinary rounds).
+  - Reuse first: check vibe_v5_lean_lib BEFORE writing a definition, reuse archived
+    content via `import Formal.Lib.<name>` / `import Formal.Proved.<name>` (the compile
+    gets `--search-path <VibeMath root>`, preceded by any leanSearchPaths), or copy the
+    exact text with vibe_v5_lean_read. Re-archiving identical content is de-duplicated.
+  - Compiles are ASYNC by default (leanAsync=true, leanJobsMaxParallel default 1):
+    vibe_v5_lean_run / vibe_v5_lean_archive enqueue and return at once; watch them with
+    vibe_v5_lean_job {jobId, waitMs} or vibe_v5_lean_lib.jobs, and NEVER treat an object
+    as passed before its job settles ok (exit 0, same content, same build context).
+  - Only formalize what you are confident about; when unsure record kind='blocked' with a
+    reason instead of dressing uncertainty up as a formalization.
   - vibe_v5_status / vibe_v5_report show the mode, per-object formal status and the
     formalization TODO. The framework never installs Lean and never judges fidelity.