pi-multi-viewers 0.4.0 → 0.5.1

package/observability.py

@@ -120,8 +120,6 @@ def check_status(base):
         return "not-exists"
     # 读路径统一走 fs.run_git（quotepath 加固单点；run_cmd 只做一次性
     # 环境命令——init/clone/config/push）
-    # 读路径统一走 fs.run_git（quotepath 加固单点；run_cmd 只做一次性
-    # 环境命令——init/clone/config/push）
     agents = meeting_fs.read_protocol(bare).get("participants", [])
     # "收尾完成"判据**单源** = human_viewer.is_finished（concluded 且
     # HEAD:result.md 有效）——与 viewer 的 done 同一判据（§3.5-P5：此前
@@ -327,6 +325,9 @@ def build_report(base):
                    f"{_dur(d['max_ms'] // 1000)} | rc≠0 {d['fails']} 次")
 
     # ---- LLM 运行事实（session 文档化字段；流式预过滤，不整文件解析） ----
+    # ---- 扩展策略（声明 vs 生效）----
+    _report_extension_line(base, out)
+
     # ---- 终止原因（只报事实与计数）----
     _report_termination(base, agents, out)
 
@@ -618,6 +619,46 @@ def _report_termination(base, agents, out):
                + (" | result.md 已提交" if has_result else ""))
 
 
+def _report_extension_line(base, out):
+    """扩展策略：**声明 vs 生效**（+ 降级原因）——与"档位：声明 max ｜ 生效 max"同型。
+
+    取数（只读已有家，零新增记录）：
+      · 声明 = `protocol.json.extensionPolicy`（无该字段的旧产物 → n/a）
+      · 生效 = loop log 的**登记行**（首唤打一次）：
+        `扩展策略: 声明=<x> 生效=<y> strict=<0|1>[ 降级原因=<reason>]`
+    为什么需要它：降级本来是**可见的**（loop log 一行），但产品面（报告）看不到
+    ——2026-09-14 为确认"MC 生效没有"花了好几轮探针 + DB 查询（e2e24 评审 E2）。
+    fail-open：读不到 → 显示 n/a，不报错。
+    """
+    bare = meeting_fs.bare_of_base(base)
+    proto = meeting_fs.read_protocol(bare)
+    declared = proto.get("extensionPolicy")
+    eff = None
+    for f in sorted(glob.glob(os.path.join(base, "loop-*.log"))):
+        try:
+            txt = open(f, encoding="utf-8", errors="replace").read()
+        except OSError:
+            continue
+        m = re.search(r"扩展策略: 声明=(\S+) 生效=(\S+) strict=(\d)"
+                      r"(?: 降级原因=(.*))?", txt)
+        if m:
+            eff = m
+            break
+    if not declared and not eff:
+        out.append("扩展策略：n/a（协议无字段、日志无登记行——多为 2026-09-14 前的产物）")
+        return
+    if eff:
+        d, e, strict, reason = eff.group(1), eff.group(2), eff.group(3), eff.group(4)
+        line = f"扩展策略：声明 {d} ｜ 生效 {e}（strict={strict}"
+        line += f"，降级：{reason.strip()}" if reason else ""
+        line += "）"
+        if d != e:
+            line += "  ⚠ 生效≠声明（降级：ctx_search 不可用）"
+        out.append(line)
+    else:
+        out.append(f"扩展策略：声明 {declared} ｜ 生效 n/a（日志中无登记行）")
+
+
 def _report_wake_fields(base):
     """解析 loop-*.log 的登记字段（`elapsed_ms` / `rc`）。
 

package/package.json

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

package/prompts/multi-viewers.md

@@ -86,7 +86,7 @@ argument-hint: '"<主题>"'
 ## 收尾（用户驱动）
 
 ```bash
-mv.sh --status      # done/stopped/running（目录可省略——自动定位当前分析）
+mv.sh --status      # 状态 + [result] 路径（目录可省略——自动定位当前分析）
 ```
 
 - `done`：读上一步打印的 `[result]` 路径（产物固定位；**路径由命令给出，

package/spec_gen.py

@@ -17,8 +17,7 @@ import sys
 
 HERE = os.path.dirname(os.path.abspath(__file__))
 TPL_DIR = os.path.join(HERE, "templates")
-PI_AGENT_DIR = os.environ.get("PI_CODING_AGENT_DIR",
-                             os.path.expanduser("~/.pi/agent"))
+# pi agent 目录的**单一实现**在 meeting_fs.pi_agent_dir()（F9：此前两处各拼一次）
 MAX_AGENT_NAME_LEN = 32
 
 import meeting_fs
@@ -56,7 +55,7 @@ def _default_model():
     获取失败（pi 不可用/无 settings）→ 返回 None。
     """
     try:
-        with open(os.path.join(PI_AGENT_DIR, "settings.json")) as f:
+        with open(os.path.join(meeting_fs.pi_agent_dir(), "settings.json")) as f:
             cfg = json.load(f)
         provider = cfg.get("defaultProvider") or ""
         model = cfg.get("defaultModel") or ""
@@ -123,7 +122,7 @@ def pi_sessions_dir(cwd):
     AGENTS.md 明言"编码错一根横线 = 静默解析不到"——风险点不应复制。
     """
     enc = "--" + cwd.strip("/").replace("/", "-") + "--"
-    return os.path.join(PI_AGENT_DIR, "sessions", enc)
+    return os.path.join(meeting_fs.pi_agent_dir(), "sessions", enc)
 
 
 def current_session_file():
@@ -370,7 +369,8 @@ def gen_question(topic, stances, background, questions):
     return "\n".join(lines)
 
 
-def gen_protocol(topic, participants, max_meeting, max_rr, extensions=False,
+def gen_protocol(topic, participants, max_meeting, max_rr,
+                 extension_policy=meeting_fs.DEFAULT_EXTENSION_POLICY,
                  result_writer=None,
                  stall_timeout=DEFAULT_STALL_TIMEOUT,
                  fork_source=None, fork_cwd=None,
@@ -388,8 +388,12 @@ def gen_protocol(topic, participants, max_meeting, max_rr, extensions=False,
         "stallTimeoutSeconds": stall_timeout,
         "commitPolicy": "one-message-per-commit",
     }
-    # 显式写出扩展策略（默认零扩展 = agents 不加载任何外部扩展）
-    proto["extensions"] = bool(extensions)
+    # 显式写出扩展策略（值域与默认值的家在 meeting_fs；此处只写选定值）。
+    # 非法值就地报错（不落盘半成品）——与 forkMode 同款：配置错误不进运行时
+    if extension_policy not in meeting_fs.EXTENSION_POLICIES:
+        raise ValueError(f"非法 extension_policy: {extension_policy!r}"
+                         f"（合法值: {'/'.join(meeting_fs.EXTENSION_POLICIES)}）")
+    proto["extensionPolicy"] = extension_policy
     if fork_source:
         # fork 模式（多视角）：首唤挂载主 session + cwd=主项目
         # forkMode 取值域与默认值的定义在 meeting_fs（FORK_MODES /

package/start_discussion.py

@@ -3,7 +3,8 @@
 
 用法：
   python3 start_discussion.py --dir mymeet --topic "主题" --agents a,b \
-      [--stances '{"a": "立场1", "b": "立场2"}'] [--start] [--extensions] \
+      [--stances '{"a": "立场1", "b": "立场2"}'] [--start] \
+      [--extension-policy none|mc-tools|all] \
       [--models '{"a": "provider/model"}'] [--max-meeting 10] [--max-rr 7]
 
 复杂内容用 spec 规格目录（设计 16，与 CLI 内容参数互斥）：
@@ -350,7 +351,7 @@ def setup_environment(args, participants, base, spec_dir=None,
     # 共享配置（work-a 提交，setup commit 进 bare）
     with open(os.path.join(wa, "protocol.json"), "w") as f:
         json.dump(gen_protocol(spec_topic or args.topic, participants, args.max_meeting,
-                               args.max_rr, args.extensions, args.result_writer,
+                               args.max_rr, args.extension_policy, args.result_writer,
                                args.stall_timeout,
                                fork_source=getattr(args, "fork_source", None),
                                fork_cwd=os.getcwd(),
@@ -420,7 +421,7 @@ def setup_environment(args, participants, base, spec_dir=None,
     print(f"[setup] 环境就绪: {base}（{len(participants)} agents: {', '.join(participants)}）")
     print(f"[setup] resultWriter={rw}, maxMeeting={args.max_meeting}, maxRR={args.max_rr}, "
           f"立场={'有' if (args.stances or spec_dir) else '无'}, "
-          f"extensions={args.extensions}")
+          f"extensionPolicy={args.extension_policy}")
 
 
 def _preserve_result_md(base):
@@ -512,7 +513,7 @@ from spec_gen import (  # noqa: F401
     viewer_set_error, gen_agents_md, gen_protocol,
     pi_sessions_dir, current_session_file, _join_model_ref,
     _default_model, _detect_pi_model_thinking, resolve_fork_source,
-    PI_AGENT_DIR, MAX_AGENT_NAME_LEN,
+    MAX_AGENT_NAME_LEN,
 )
 from observability import (  # noqa: F401
     _loop_pids, _loops_alive, check_status, build_report,
@@ -550,9 +551,13 @@ def main():
                              "protocol.json，各 agent 首唤由本地生成 fork "
                              "源挂载主上下文；不传 = 从主 pi 环境自动解析"
                              "（PI_SESSION_ID；解析失败明确报错）")
-    parser.add_argument("--extensions", action="store_true",
-                        help="让 agents 加载外部扩展（默认零扩展：不加载任何"
-                             "外部扩展/技能/prompt-template/主题）")
+    parser.add_argument(
+        "--extension-policy",
+        choices=list(meeting_fs.EXTENSION_POLICIES),
+        default=meeting_fs.DEFAULT_EXTENSION_POLICY,
+        help="agents 的扩展策略：mc-tools=默认，只要 MC 的只读检索工具 "
+             "ctx_search（缺 MC 时可见降级为零扩展）；none=零扩展（零依赖）；"
+             "all=走 pi 默认发现")
     parser.add_argument("--start", action="store_true", help="创建后启动讨论")
     parser.add_argument("--skip-setup", action="store_true",
                         help="跳过环境生成，只启动已有环境（需 --dir）")
@@ -704,12 +709,13 @@ def main():
             workdir = os.path.join(base, f"work-{p}")
             cmd = [sys.executable, os.path.join(base, "meeting_loop.py"),
                    workdir, p]
-            if args.extensions:
-                cmd.append("--extensions")
+            # 扩展策略**不转发**：协议字段（gen_protocol 恒写）是唯一权威，
+            # 转发只会多一条通道（S3）。例外语义已写进 decision 20：旧协议
+            # 目录（无该字段）按默认档启动。
             # 配额（max-meeting/max-rr/stall-timeout）是环境属性：创建时
             # 固化在 protocol.json，启动继承（loop 读 protocol 优先）。
             # 不传 CLI —— 避免无条件覆盖 protocol.json 的固化值
-            # （审核 C1：配额单一事实源；与 extensions 处理一致）
+            # （审核 C1：配额单一事实源；与 extension-policy 处理一致）
             with open(os.path.join(base, f"loop-{p}.log"), "w") as f:
                 procs.append(subprocess.Popen(cmd, stdout=f,
                                               stderr=subprocess.STDOUT,