dsh-vibe-math 2.6.0 → 2.7.0

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

@@ -5,7 +5,7 @@
 
 ## vibe-math-v2
 
-- 注册工具数：**25**
+- 注册工具数：**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
@@ -33,9 +33,15 @@ programmatically runs explorer (direction setting) → per-direction solvers (ag
 - 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 时显式告警。
 
 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
@@ -74,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
@@ -107,9 +113,15 @@ programmatically runs explorer (direction setting) → per-direction solvers (ag
 - 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 时显式告警。
 
 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
@@ -148,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
@@ -159,7 +171,7 @@ LEAN FORMAL VERIFICATION (formalVerify, a tunable parameter):
 
 ## vibe-math-v3
 
-- 注册工具数：**33**
+- 注册工具数：**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
@@ -211,9 +223,15 @@ 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|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]).
@@ -241,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
@@ -299,9 +317,15 @@ 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|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]).
@@ -329,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
@@ -341,7 +365,7 @@ When the user asks about progress, call vibe_math_report and summarize in plain
 
 ## vibe-math-v4
 
-- 注册工具数：**32**
+- 注册工具数：**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
@@ -391,15 +415,20 @@ 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, 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. 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_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|paper [lang=zh|en] [format=md|tex|both] [editor=office|resident:<id>] [force]|members|add|remove|set <k=v>...).
@@ -433,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.
@@ -490,15 +528,20 @@ 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, 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. 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_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|paper [lang=zh|en] [format=md|tex|both] [editor=office|resident:<id>] [force]|members|add|remove|set <k=v>...).
@@ -532,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.
@@ -545,7 +597,7 @@ When the user asks about progress, call vibe_v4_report and summarize in plain la
 
 ## vibe-math-v5
 
-- 注册工具数：**37**
+- 注册工具数：**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
@@ -620,9 +672,12 @@ Main controls (recommended flow: configure FIRST, then start):
   - vibe_v5_add_researcher / vibe_v5_remove_researcher — OFFICE only: add or dismiss a PERMANENT researcher (the academician can only propose those).
   - 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 — Lean formal
-    verification (execute / archive / list the reuse library). Members use them
-    too; they work in every mode.
+  - 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):
@@ -638,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.
 
@@ -721,9 +789,12 @@ Main controls (recommended flow: configure FIRST, then start):
   - vibe_v5_add_researcher / vibe_v5_remove_researcher — OFFICE only: add or dismiss a PERMANENT researcher (the academician can only propose those).
   - 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 — Lean formal
-    verification (execute / archive / list the reuse library). Members use them
-    too; they work in every mode.
+  - 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):
@@ -739,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.