pi-multi-viewers 0.6.0 → 0.7.0

package/README.md

@@ -94,6 +94,8 @@ ls viewers/
 scripts/mv.sh --prepare "<主题>"              # spec = question.md(+background.md)
 scripts/mv.sh --start <spec目录>              # 启动（自动挂载主 session；默认 budget 模式）
 #  可选：--fork-mode compaction|budget|full（见上表；一般不调）
+#  可选：--max-meeting 15 --max-rr 7 --stall-timeout 600
+#        （配额：建环境时固化进 protocol.json，之后不可改；meeting 配额是"每 agent"）
 #  可选：--extension-policy mc-tools|none|all（默认 mc-tools = agents 带 MC 的只读检索工具
 #        ctx_search；none = 零扩展、零依赖；all = 走 pi 默认发现。缺 MC 时 mc-tools 可见降级）
 #  高级：--agents "a,b" 起一次性视角（不建 viewers/ 时用；prompt 入口不传它）

package/meeting_engine.py

@@ -36,6 +36,7 @@ from meeting_fs import (
     read_protocol, cat_batch, remove_message, write_text, file_size,
     bare_of_base, bare_of_workdir, log,
     RESULT_MD, RESULT_MD_MIN_BYTES, DEFAULT_STALL_TIMEOUT,
+    DEFAULT_MAX_MEETING, DEFAULT_MAX_RR,
 )
 from meeting_core import (
     meeting_speak_count as core_meeting_speak_count,
@@ -503,7 +504,9 @@ def _commit_result_md(workdir, agent, subject):
         log(agent, "result.md 无改动——跳过 commit（幂等）")
 
 
-def agent_loop(workdir, agent, responder, max_meeting=10, max_rr=7,
+def agent_loop(workdir, agent, responder,
+               max_meeting=DEFAULT_MAX_MEETING,
+               max_rr=DEFAULT_MAX_RR,
                poll_interval=POLL_INTERVAL,
                stall_timeout=DEFAULT_STALL_TIMEOUT):
     """主状态机（v2）。responder 注入：响应一轮并返回是否产出。

package/meeting_fs.py

@@ -47,8 +47,12 @@ def result_path(base):
     """
     return f"{base}-{RESULT_MD}"
 
-# 无进展超时兜底（秒）——协议参数的默认值（gen_protocol 固化进
-# protocol.json；engine/fake_agent 的签名默认与 CLI default 同源于此）。
+# 协议参数默认值（gen_protocol 固化进 protocol.json）——**唯一声明点**：
+# CLI default、engine 签名默认、observability 的兜底读取都引用这里
+# （此前 10/7 在三处各写一遍，改一处不改另一处就会漂移）。
+DEFAULT_MAX_MEETING = 15   # meeting 阶段**每 agent** 发言配额
+DEFAULT_MAX_RR = 7         # RR 阶段轮次配额
+# 无进展超时兜底（秒）——同上（engine/fake_agent 的签名默认与 CLI default 同源）。
 DEFAULT_STALL_TIMEOUT = 600
 
 # thinking 档位缺省值——**唯一声明点**：models.md 的 variant 槽（缺省）

package/mv_cli.py

@@ -45,6 +45,8 @@ USAGE = f"""用法:
   {PROG} --prepare "<问题>" [--background "<背景>"] [--agents "a,b,c"|4]
   {PROG} --start <spec目录> [--fork-mode compaction|budget|full]
   {PROG} --start <spec目录> [--extension-policy none|mc-tools|all]
+  {PROG} --start <spec目录> [--max-meeting N] [--max-rr N] [--stall-timeout S]
+                             # 配额：建环境时固化进 protocol.json（默认 15 / 7 / 600）
   {PROG} --status  [dir]
   {PROG} --report  [dir]
   {PROG} --wait    [dir]
@@ -57,7 +59,8 @@ USAGE = f"""用法:
 mv-<PI_SESSION_ID>-* 最新；无匹配则报错要求显式传目录）
 
 默认参数:
-  agents=a,b,c  max-meeting=10  max-rr=7   # 配额默认值的权威在 python argparse（本层不传）
+  agents=a,b,c  max-meeting=15  max-rr=7   # 默认值的权威在 python argparse；
+                                           # 配额可在 --start 时传（建环境时固化，运行中不可改）
 
 --agents: 逗号分隔名称列表（如 "x,y"）或纯数字（如 4 → 生成 a..d）；
           human 是保留名，不能作为参与者

package/observability.py

@@ -284,7 +284,7 @@ def build_report(base):
     # msgs 由上方流程段一次读取提供（同一读取派生四段）。
     lasts = {a: (msgs[a][-1] if msgs[a] else None) for a in agents}
     types = {a: (lasts[a].get("type") if lasts[a] else None) for a in agents}
-    quota_meeting = proto.get("maxMeetingRounds", 10)
+    quota_meeting = proto.get("maxMeetingRounds", meeting_fs.DEFAULT_MAX_MEETING)
     quota_rr = proto.get("maxRRRounds", 7)
     out.append("配额：meeting " + "、".join(
         f"{a} {meeting_core.meeting_speak_count(msgs, a)}/{quota_meeting}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-multi-viewers",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Multi-perspective analysis for Pi: fork the main session into N perspective agents over the meeting protocol.",
   "type": "module",
   "private": false,

package/start_discussion.py

@@ -5,7 +5,7 @@
   python3 start_discussion.py --dir mymeet --topic "主题" --agents a,b \
       [--stances '{"a": "立场1", "b": "立场2"}'] [--start] \
       [--extension-policy none|mc-tools|all] \
-      [--models '{"a": "provider/model"}'] [--max-meeting 10] [--max-rr 7]
+      [--models '{"a": "provider/model"}'] [--max-meeting 15] [--max-rr 7]
 
 复杂内容用 spec 规格目录（设计 16，与 CLI 内容参数互斥）：
   1. 生成骨架:  python3 start_discussion.py --spec-gen myspec --agents a,b,c
@@ -532,7 +532,8 @@ def main():
     parser.add_argument("--questions", default=None, help="待回答问题（|分隔，对齐 RR）")
     parser.add_argument("--models", default=None, help='JSON: {"a": "provider/model"}')
     parser.add_argument("--result-writer", default=None, help="resultWriter（默认最后一位参与者）")
-    parser.add_argument("--max-meeting", type=int, default=10, help="meeting 阶段发言配额（每 agent）")
+    parser.add_argument("--max-meeting", type=int, default=meeting_fs.DEFAULT_MAX_MEETING,
+                        help="meeting 阶段发言配额（每 agent）")
     parser.add_argument("--max-rr", type=int, default=7, help="RR 阶段轮次配额（starter）")
     parser.add_argument("--stall-timeout", type=int,
                         default=meeting_fs.DEFAULT_STALL_TIMEOUT,