pomaster 0.1.0 → 0.2.0

package/catalog/knowledge/knowledge.web.browser.mcp_eyes.json

@@ -0,0 +1,99 @@
+{
+  "x-vocab-pr": {
+    "status": "vocab_pr_registered__source_type_append_only",
+    "finding": "knowledge_entry kind 已在 vocab-lock kinds_registry.truth_bodies；classification=ENGINEERING_PATTERN 是 §83.3 四类型词形（12-knowledge-entry knowledge_kind enum 在册）；triggers 是 12-knowledge-entry 既有字段（§83.8 检索键承载）；sources[].type=owner_directive 是 Owner 有意词形（Owner 指令 2026-09-03）——暂不在 SOURCE_TYPE_ALL_VALUES 九值来源闭包（packages/schemas/src/vocab.ts），复核确认零机器校验闸拒绝（12-knowledge-entry schema 无 sources/source_type 约束；catalog knowledge 物料无 loader 词形校验；lock 只锁 path+hash——2026-09-03 质检复核实测）",
+    "proposal": "vocab PR-0007 收编：source_types 轴 append-only 增值 owner_directive（主 agent 于批次 2.6 收尾处理）；收编前本条目零机器闸依赖该词形，词表文件零改动（locked_vocab_untouched）",
+    "locked_vocab_untouched": true,
+    "resolution": "2026-09-03 vocab PR-0007 收编落地（vocab-lock@v0.6-resolved，三镜像同 commit）：source_types 轴 append-only 增值 owner_directive（置于 human_directive 之后，all/allowed 同步增值、forbidden 两值不动）——上记 pending 注记就此转正；finding/proposal/locked_vocab_untouched 为批次 2.6 创建时点历史记录原样保留"
+  },
+  "x-advisory-gate-semantics": {
+    "advisory": true,
+    "gate_binding": "NEVER_FAIL",
+    "statement": "本条目为 advisory 知识：任何 gate 永不因本条目 FAIL；至多产生 WARN/HINT 或进入 Human Review 议程（§83.2 铁律「Knowledge 不能直接让 Gate FAIL」——knowledge 恒 ADVISORY 永不进 gate 判卷）"
+  },
+  "x-browser-eyes": {
+    "note": "浏览器双眼引导（P-v06 批次 2.6，Owner 指令 2026-09-03）：观测与验证两眼分工显式化。架构锚=gauntlet BROWSER 双通道（packages/gauntlet-lite/src/browser-legs.ts BROWSER_LEG_ORDER：Playwright ∥ chrome-devtools MCP，两腿两记录无聚合 verdict）+ Sensor Capability Catalog 双眼登记（catalog/sensors/sensor.browser.interactive.json / sensor.browser.deterministic.json）。",
+    "eyes": {
+      "observe": "chrome-devtools-mcp=交互观测/诊断面（performance trace / network 瀑布 / console）——诊断『慢/报错/卡住』必须实测（Owner 纪律：禁只看代码推断）",
+      "verify": "@playwright/mcp=确定性 E2E smoke/交互验证（判卷锚=@playwright/test 官方 JSONReport 全量重算）"
+    },
+    "evidence_chain": "两眼产物作为证据链输入（既有消费面，零新增通路）：MCP 侧经 browser-adapter 证据三件套（a11y_snapshot/screenshot/performance_trace）入 gauntlet BROWSER 腿 GRN 与 perception OBS receipt；playwright 侧经 playwright-adapter/playwright-leg 官方报告重算入账"
+  },
+  "id": "KNOWLEDGE.WEB.BROWSER.MCP_EYES",
+  "kind": "knowledge_entry",
+  "axis_profile": "knowledge_default",
+  "classification": "ENGINEERING_PATTERN",
+  "axes": {
+    "lifecycle": "PROPOSED",
+    "confidence": "UNRESOLVED",
+    "evidence": "PLANNED",
+    "change": "STABLE"
+  },
+  "title_zh": "浏览器双眼：chrome-devtools MCP 观测 + playwright MCP 验证",
+  "statement_zh": "遇到界面『慢/报错/卡住』时，必须用 chrome-devtools MCP 实测诊断（performance trace / network 瀑布 / console 观测，禁只看代码推断——Owner 纪律）；需要 E2E smoke 或交互验证时，用 playwright MCP 确定性驱动（与 @playwright/test 官方报告腿同源判卷）。两眼不是替代关系：观测眼回答「实际发生了什么」，验证眼回答「行为是否仍然正确」；两眼产物（快照/截图/trace/console/network 观测/官方报告）都进入 BROWSER 双通道证据链，而不是停留在聊天记录里。",
+  "statement_en_keywords": [
+    "browser eyes",
+    "chrome-devtools mcp",
+    "playwright mcp",
+    "performance trace",
+    "network waterfall",
+    "console observation",
+    "e2e smoke",
+    "evidence chain"
+  ],
+  "triggers": [
+    "页面慢",
+    "页面报错",
+    "页面卡住",
+    "慢",
+    "报错",
+    "卡住",
+    "性能追踪",
+    "性能诊断",
+    "网络瀑布",
+    "控制台",
+    "console",
+    "浏览器验证",
+    "浏览器诊断",
+    "e2e",
+    "smoke",
+    "交互验证",
+    "browser",
+    "chrome-devtools",
+    "playwright"
+  ],
+  "applies_when": {
+    "lane": "frontend",
+    "condition": "浏览器侧诊断与端到端验证（页面慢/报错/卡住的实测诊断；E2E smoke/交互验证取证）",
+    "lanes": [
+      "frontend"
+    ],
+    "applicability_note": "浏览器侧诊断与端到端验证"
+  },
+  "enforcement": "advisory",
+  "authority": {
+    "owner": "HUMAN_OWNER",
+    "delegates": [],
+    "write_policy": "EVOLUTION_CHANNEL",
+    "escalation_hint": "catalog-pilot-human-review"
+  },
+  "origin": "natural",
+  "sources": [
+    {
+      "type": "owner_directive",
+      "ref": "Owner 指令（2026-09-03）：vNext 推荐/引导 AI 用 chrome-devtools MCP 与 playwright MCP 构建『眼睛』——chrome-devtools MCP=交互观测/诊断面，playwright MCP=确定性 E2E smoke/交互验证",
+      "captured_by": "agent:claude/p-v06-batch2.6-browser-eyes",
+      "locator": {
+        "section": "P-v06 批次 2.6 Browser Eyes 引导"
+      }
+    }
+  ],
+  "review_notes": [
+    "ADVISORY 引导条目：只引导不判卷——gate_binding=NEVER_FAIL（§83.2 铁律）；能力登记面见 SENSOR.BROWSER.INTERACTIVE / SENSOR.BROWSER.DETERMINISTIC（双眼的能力层），本条目是双眼的经验层引导"
+  ],
+  "review": {
+    "disposition": "ACCEPT",
+    "seq": "p-v06-batch2.6-0001",
+    "ref": "P-v06 批次 2.6 Browser Eyes（Owner 指令 2026-09-03）"
+  }
+}

package/catalog/sensors/sensor.browser.deterministic.json

@@ -8,8 +8,8 @@
   },
   "id": "SENSOR.BROWSER.DETERMINISTIC",
   "kind": "sensor_capability",
-  "title_zh": "浏览器确定性回归 Sensor（Playwright 通道）",
-  "statement_zh": "经 @playwright/test 官方 JSONReport 对用户界面做确定性回归观察：官方报告全量重算 + console/network 双维度完整性强制（缺维=not_run）；与 MCP 交互腿互不替代（§6.6）、互不牵连（两腿两记录，无聚合 verdict 位）。",
+  "title_zh": "浏览器确定性回归 Sensor（playwright 首选 + MCP 双眼）",
+  "statement_zh": "经 @playwright/test 官方 JSONReport 对用户界面做确定性回归观察：官方报告全量重算 + console/network 双维度完整性强制（缺维=not_run）。双眼分工（P-v06 批次 2.6 Browser Eyes）：playwright（@playwright/test 官方报告腿）=确定性 E2E smoke/交互验证首选；@playwright/mcp=确定性 smoke 的 MCP 形态；chrome-devtools-mcp=确定性快照/截图取证。与 MCP 交互观测腿互不替代（§6.6）、互不牵连（两腿两记录，无聚合 verdict 位）。",
   "surfaces": [
     "USER_SURFACE",
     "INTERACTION_STATE",
@@ -33,7 +33,9 @@
     "network_observation"
   ],
   "implementations": [
-    "playwright"
+    "playwright",
+    "@playwright/mcp",
+    "chrome-devtools-mcp"
   ],
   "availability_probe": {
     "surface": "toolDetectors",
@@ -46,8 +48,17 @@
   "fallback_note": "空数组=显式登记无降级（§6.6 明言 Browser MCP 与 Playwright 不是互相替代）；@playwright/test 缺席 → not_run 显式，禁静默。",
   "x-source-anchors": {
     "adapter": "packages/gauntlet-lite/src/playwright-adapter.ts + playwright-leg.ts（确定性腿：官方 JSONReport 词形解析）",
-    "doctor_row": "packages/cli/src/doctor.ts playwright 探针行",
-    "detector": "packages/gauntlet-lite/src/index.ts toolDetectors.playwright（15 探测器单一事实源）"
+    "doctor_row": "packages/cli/src/doctor.ts playwright 探针行 + playwright_mcp 探针行（P-v06 批次 2.6 同款四态）",
+    "detector": "packages/gauntlet-lite/src/index.ts toolDetectors.playwright（15 探测器单一事实源）",
+    "eyes_knowledge": "catalog/knowledge/knowledge.web.browser.mcp_eyes.json（KNOWLEDGE.WEB.BROWSER.MCP_EYES——双眼分工的 ADVISORY 检索引导）"
   },
-  "x-prd": "POMaster-vNext-PRD-v0.5.2 §6.5 + §14 P1-5；裁决 8（2026-09-01）D6=A/D7=A"
+  "x-browser-eyes": {
+    "note": "浏览器双眼·确定性验证面（P-v06 批次 2.6 Browser Eyes 引导）：E2E smoke/交互验证首选 playwright（@playwright/test 官方 JSONReport 全量重算）；@playwright/mcp 可跑确定性 smoke 的 MCP 形态；chrome-devtools-mcp 提供确定性快照/截图取证。产物经 playwright-adapter/playwright-leg 官方报告重算入 gauntlet BROWSER 腿 GRN 证据链；与交互观测面（SENSOR.BROWSER.INTERACTIVE）互不替代（§6.6）。",
+    "eyes": {
+      "verify_first": "playwright（确定性 E2E smoke 首选——官方 JSONReport 全量重算）",
+      "verify_mcp": "@playwright/mcp（确定性 smoke 的 MCP 形态）",
+      "snapshot": "chrome-devtools-mcp（确定性快照/截图）"
+    }
+  },
+  "x-prd": "POMaster-vNext-PRD-v0.5.2 §6.5 + §14 P1-5；裁决 8（2026-09-01）D6=A/D7=A；P-v06 批次 2.6 Browser Eyes 双眼显式化（Owner 指令 2026-09-03）"
 }

package/catalog/sensors/sensor.browser.interactive.json

@@ -8,8 +8,8 @@
   },
   "id": "SENSOR.BROWSER.INTERACTIVE",
   "kind": "sensor_capability",
-  "title_zh": "浏览器交互诊断 Sensor（MCP 通道）",
-  "statement_zh": "对运行中的用户界面做交互式诊断观察：进入/导航/点击/输入/快照/截图/网络与控制台检查/性能追踪。本条目只登记能力不绑定具体工具（§6.5 原则：POMaster reasons about capability / Runtime binds concrete tool——项目 Truth 禁写死 MCP）；证据字节由编排方入 evidence pack，本条目为纯能力描述物料（§92.2：Catalog 不是第二套 Project Truth）。",
+  "title_zh": "浏览器交互诊断 Sensor（MCP 双眼·观测面）",
+  "statement_zh": "对运行中的用户界面做交互式诊断观察：进入/导航/点击/输入/快照/截图/网络与控制台检查/性能追踪。双眼分工（P-v06 批次 2.6 Browser Eyes）：chrome-devtools MCP=交互观测/诊断面（snapshot/network/console/性能 trace——诊断『慢/报错/卡住』必须实测，禁只看代码推断）；@playwright/mcp=交互驱动；playwright=库直驱交互。本条目只登记能力不绑定具体工具（§6.5 原则：POMaster reasons about capability / Runtime binds concrete tool——项目 Truth 禁写死 MCP）；证据字节由编排方入 evidence pack，本条目为纯能力描述物料（§92.2：Catalog 不是第二套 Project Truth）。",
   "surfaces": [
     "USER_SURFACE",
     "INTERACTION_STATE",
@@ -38,7 +38,8 @@
   ],
   "implementations": [
     "chrome-devtools-mcp",
-    "playwright"
+    "playwright",
+    "@playwright/mcp"
   ],
   "availability_probe": {
     "surface": "toolDetectors",
@@ -51,8 +52,17 @@
   "fallback_note": "空数组=显式登记无降级（§6.6 明言 Browser MCP 与 Playwright 不是互相替代：MCP 适合探索/交互诊断，Playwright 适合确定性回归）；未来 Sensor Resolution（P0.5-4）如需降级语义再扩。",
   "x-source-anchors": {
     "adapter": "packages/gauntlet-lite/src/browser-adapter.ts（MCP 交互腿 adapter：握手 smoke + 证据三件套判卷）",
-    "doctor_row": "packages/cli/src/doctor.ts chrome_devtools_mcp 探针行（D22 探测 + 一键引导）",
-    "detector": "packages/gauntlet-lite/src/index.ts toolDetectors.chromeDevtoolsMcp（15 探测器单一事实源）"
+    "doctor_row": "packages/cli/src/doctor.ts chrome_devtools_mcp 探针行（D22 探测 + 一键引导）+ playwright_mcp 探针行（P-v06 批次 2.6 同款四态）",
+    "detector": "packages/gauntlet-lite/src/index.ts toolDetectors.chromeDevtoolsMcp（15 探测器单一事实源）",
+    "eyes_knowledge": "catalog/knowledge/knowledge.web.browser.mcp_eyes.json（KNOWLEDGE.WEB.BROWSER.MCP_EYES——双眼分工的 ADVISORY 检索引导）"
   },
-  "x-prd": "POMaster-vNext-PRD-v0.5.2 §6.5 例文逐字 + §14 P1-5；裁决 8（2026-09-01）D6=A/D7=A"
+  "x-browser-eyes": {
+    "note": "浏览器双眼·交互观测面（P-v06 批次 2.6 Browser Eyes 引导）：诊断『慢/报错/卡住』必须 chrome-devtools MCP 实测（performance trace / network / console，禁只看代码推断——Owner 纪律）；两眼产物（快照/截图/trace/console/network 观测）经 browser-adapter 证据三件套判卷，作为 gauntlet BROWSER 腿 GRN 与 perception OBS receipt 的证据链输入（既有消费面，本条目不新增通路）。与确定性面（SENSOR.BROWSER.DETERMINISTIC）互不替代（§6.6）。",
+    "eyes": {
+      "observe": "chrome-devtools-mcp（交互观测/诊断面：snapshot/network/console/性能 trace）",
+      "drive": "@playwright/mcp（交互驱动）",
+      "library": "playwright（库直驱交互）"
+    }
+  },
+  "x-prd": "POMaster-vNext-PRD-v0.5.2 §6.5 例文逐字 + §14 P1-5；裁决 8（2026-09-01）D6=A/D7=A；P-v06 批次 2.6 Browser Eyes 双眼显式化（Owner 指令 2026-09-03）"
 }

package/catalog/tools/materialize_v06_relock.py

@@ -0,0 +1,218 @@
+# -*- coding: utf-8 -*-
+"""P-v06：catalog 受控节全量重锁工具（批次 1/2 archetypes 分桶先例 → 批次 2.6 扩为全受控节扫描）。
+
+职责（沿 materialize_catalog_pilot.py 合并重锁先例——基线零触碰，只做确定性重建；
+语义对齐 kernel relockCatalog（P-v06 批次 2.5）：物料字节是身份源，hash 恒重算；
+provenance 是人类可维护的登记位，沿 previous 不重写历史，仅新登记物料给确定性缺省）：
+  1. 全受控节扫描（archetypes/gates/knowledge/policies/sensors——kernel catalog.ts
+     CATALOG_SECTIONS 同名五节闭包）逐文件计算 content_sha256；
+  2. source_ref 分桶（历史分桶逻辑保留 + 本批增量）：
+     - archetypes/*.json            → 批次 1/2/3/4 按 id 前缀或精确 id 分桶（seed 工具
+       实抓锚，如实到批；批次 3 分桶精确到不失真——CRUD/QUERY/DATA.MASTER_DATA
+       仍归批次 1）；
+     - gates/gate.new-entity.checks.json → 批次 1 relock 判卷定义锚；
+     - sensors/sensor.browser.{interactive,deterministic}.json → 批次 2.6 Browser Eyes 锚
+       （双眼 implementations 显式化，Owner 指令 2026-09-03）；
+     - knowledge/knowledge.web.browser.mcp_eyes.json → 批次 2.6 Browser Eyes 锚
+       （KNOWLEDGE.WEB.BROWSER.MCP_EYES 新登记，gate_binding=NEVER_FAIL）；
+     - 其余条目                      → 沿 previous 同路径 source_ref（不重写历史）；
+       previous 无此路径（理论上仅手工删除 lock 段的恢复场景）→ package://catalog/<path>。
+  3. lock 全量重锁：entries（按 id 排序）/ controlled_children allowed+required
+     （全部扫描路径——加删文件后三方自动对齐）；
+  4. generated_by 追加批次注记（幂等：已含则不重复追加；批次 1/2/2.6/3/4 各一记，历史留痕）。
+
+纪律：content_sha256 = sha256(utf-8 字节)（与 kernel verifyCatalogLock 同一算法，
+producer 与对账端共用同一计算）；幂等 byte-stable（DEF-POM-002 教训；A4 无时戳）；
+D24——lock 是 read-side 指纹，漂移 WARN+auto-regen 不拦写。
+"""
+import hashlib
+import json
+import os
+import sys
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8")
+except Exception:
+    pass
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))  # .../catalog
+LOCK = os.path.join(ROOT, "catalog-lock.draft.json")
+# 受控五节（kernel catalog.ts CATALOG_SECTIONS 同名闭包；tools/candidates/
+# projection-presets 与 lock 自身不在管辖面——verifyCatalogLock 同口径）。
+SECTIONS = ["archetypes", "gates", "knowledge", "policies", "sensors"]
+NEW_GATE = "gates/gate.new-entity.checks.json"
+GENERATED_BY_MARK = "catalog/tools/seed_v06_archetypes.py + materialize_v06_relock.py（P-v06 批次 1：archetypes 十条目 + GATE.NEW_ENTITY.CHECKS 登记，D-2/D-4 裁决）"
+GENERATED_BY_MARK_BATCH2 = "catalog/tools/seed_v06_batch2_materials.py + materialize_v06_relock.py（P-v06 批次 2：STATE_ARCHETYPE 八态 + FRONTEND_ARCHETYPE 三型 + ERROR_TAXONOMY 十二条目，research frontend-state-references.md 2026-09-03 锚）"
+GENERATED_BY_MARK_BATCH26 = "catalog/tools/materialize_v06_relock.py（P-v06 批次 2.6 Browser Eyes：SENSOR.BROWSER.* 双眼 implementations 显式化 + KNOWLEDGE.WEB.BROWSER.MCP_EYES 登记，Owner 指令 2026-09-03）"
+GENERATED_BY_MARK_BATCH3 = "catalog/tools/seed_v06_batch3_materials.py + materialize_v06_relock.py（P-v06 批次 3：Backend/API/Data 原型十七条目，research backend-references.md 2026-09-03 锚）"
+GENERATED_BY_MARK_BATCH4 = "catalog/tools/seed_v06_batch4_materials.py + materialize_v06_relock.py（P-v06 批次 4：RUNTIME 物料两条目 ENVIRONMENT_PARITY/OBSERVABILITY_BINDING，research runtime-references.md 2026-09-03 锚）"
+
+# 批次 2 物料 id 前缀（provenance 如实到批：对应 research 报告不同，禁共用批次 1 词面）。
+BATCH2_ID_PREFIXES = ("STATE_ARCHETYPE.", "FRONTEND_ARCHETYPE.")
+SOURCE_REF_BATCH1 = "catalog/tools/seed_v06_archetypes.py（P-v06 批次 1；外部参照 external-design-references.md 2026-09-02 实抓锚）"
+SOURCE_REF_BATCH2 = "catalog/tools/seed_v06_batch2_materials.py（P-v06 批次 2；外部参照 frontend-state-references.md 2026-09-03 实抓锚）"
+
+# 批次 3 物料 id 分桶（provenance 如实到批：backend-references.md 2026-09-03 实抓锚）。
+# 分桶精确到不失真：ARCHETYPE.BACKEND.CRUD_RESOURCE/QUERY_RESOURCE 与
+# DATA_ARCHETYPE.MASTER_DATA 仍归批次 1（批次 1 物料，禁被批次 3 前缀吞并——
+# 因此 backend 侧用精确 id 枚举而非 ARCHETYPE.BACKEND. 整段前缀，data 侧用
+# TRANSACTION|VERSIONED|HIERARCHY|LEDGER 四精确 id 而非 DATA_ARCHETYPE. 整段前缀）。
+BATCH3_BACKEND_IDS = (
+    "ARCHETYPE.BACKEND.MASTER_DATA",
+    "ARCHETYPE.BACKEND.TRANSACTIONAL_WRITE",
+    "ARCHETYPE.BACKEND.OUTBOX_EVENT",
+    "ARCHETYPE.BACKEND.IDEMPOTENT_COMMAND",
+    "ARCHETYPE.BACKEND.SCHEDULED_JOB",
+    "ARCHETYPE.BACKEND.EXTERNAL_INTEGRATION",
+    "ARCHETYPE.BACKEND.APPROVAL_WORKFLOW",
+    "ARCHETYPE.BACKEND.IMPORT",
+    "ARCHETYPE.BACKEND.EXPORT",
+    "ARCHETYPE.BACKEND.AUDIT",
+)
+BATCH3_API_PREFIX = "ARCHETYPE.API."
+BATCH3_DATA_IDS = (
+    "DATA_ARCHETYPE.TRANSACTION",
+    "DATA_ARCHETYPE.VERSIONED",
+    "DATA_ARCHETYPE.HIERARCHY",
+    "DATA_ARCHETYPE.LEDGER",
+)
+SOURCE_REF_BATCH3 = "catalog/tools/seed_v06_batch3_materials.py（P-v06 批次 3；外部参照 backend-references.md 2026-09-03 实抓锚）"
+
+# 批次 4 物料 id 分桶（provenance 如实到批：runtime-references.md 2026-09-03 实抓锚）。
+# RUNTIME_ARCHETYPE. 前缀与批次 1/2/3 各桶零交集（批次 1 ARCHETYPE.BACKEND.*/API.*
+# 精确枚举、批次 2 STATE_*/FRONTEND_* 前缀、批次 3 DATA_* 四精确 id）——整段前缀
+# 分桶不吞并历史条目，不失真。
+BATCH4_ID_PREFIXES = ("RUNTIME_ARCHETYPE.",)
+SOURCE_REF_BATCH4 = "catalog/tools/seed_v06_batch4_materials.py（P-v06 批次 4；外部参照 runtime-references.md 2026-09-03 实抓锚）"
+
+
+def source_ref_for(entry_id):
+    if entry_id.startswith(BATCH4_ID_PREFIXES):
+        return SOURCE_REF_BATCH4
+    if entry_id in BATCH3_BACKEND_IDS or entry_id.startswith(BATCH3_API_PREFIX) or entry_id in BATCH3_DATA_IDS:
+        return SOURCE_REF_BATCH3
+    return (
+        SOURCE_REF_BATCH2
+        if entry_id.startswith(BATCH2_ID_PREFIXES)
+        else SOURCE_REF_BATCH1
+    )
+
+# 批次 2.6 Browser Eyes 改动条目（双眼显式化 + knowledge 新登记；Owner 指令 2026-09-03）。
+BROWSER_EYES_SENSORS = (
+    "sensors/sensor.browser.interactive.json",
+    "sensors/sensor.browser.deterministic.json",
+)
+BROWSER_EYES_KNOWLEDGE = "knowledge/knowledge.web.browser.mcp_eyes.json"
+SOURCE_REF_BATCH26_SENSORS = (
+    "catalog/tools/materialize_v06_relock.py（P-v06 批次 2.6 Browser Eyes：SENSOR.BROWSER.* "
+    "双眼 implementations 显式化——chrome-devtools-mcp 观测 + @playwright/mcp 验证；Owner 指令 2026-09-03）"
+)
+SOURCE_REF_BATCH26_KNOWLEDGE = (
+    "catalog/tools/materialize_v06_relock.py（P-v06 批次 2.6 Browser Eyes："
+    "KNOWLEDGE.WEB.BROWSER.MCP_EYES 新登记——浏览器双眼 ADVISORY 检索引导，"
+    "gate_binding=NEVER_FAIL；Owner 指令 2026-09-03）"
+)
+SOURCE_REF_BATCH26_GATE = "catalog/tools/materialize_v06_relock.py（P-v06 批次 1；v0.6.1 §75/§87 判卷定义锚）"
+
+
+def source_ref_for_path(path, body_id, previous_by_path):
+    """本批增量分桶：Browser Eyes 改动条目 → 批次 2.6 锚；archetypes/NEW_GATE →
+    批次 1/2/3 既有分桶；其余沿 previous 同路径（provenance 不重写历史）。"""
+    if path in BROWSER_EYES_SENSORS:
+        return SOURCE_REF_BATCH26_SENSORS
+    if path == BROWSER_EYES_KNOWLEDGE:
+        return SOURCE_REF_BATCH26_KNOWLEDGE
+    if path.startswith("archetypes/"):
+        return source_ref_for(body_id)
+    if path == NEW_GATE:
+        return SOURCE_REF_BATCH26_GATE
+    previous = previous_by_path.get(path)
+    if previous is not None and previous.get("source_ref"):
+        return previous["source_ref"]
+    return f"package://catalog/{path}"
+
+
+def sha256_of_file(path):
+    with open(path, "rb") as f:
+        return "sha256:" + hashlib.sha256(f.read()).hexdigest()
+
+
+def scan_section(section):
+    """扫描单节全部 *.json → (entries, paths)。逐文件读 id（缺 id 显式爆——
+    与 kernel relockCatalog 同口径：relock 以物料 id 重建 entries）。"""
+    dir_path = os.path.join(ROOT, section)
+    entries = []
+    paths = []
+    if not os.path.isdir(dir_path):
+        return entries, paths
+    for name in sorted(os.listdir(dir_path)):
+        if not name.endswith(".json"):
+            continue
+        path = f"{section}/{name}"
+        full = os.path.join(dir_path, name)
+        with open(full, encoding="utf-8") as f:
+            body = json.load(f)
+        entry_id = body.get("id")
+        if not isinstance(entry_id, str) or not entry_id:
+            raise SystemExit(f"[relock] catalog 物料缺 id 字段: {path}")
+        entries.append(
+            {
+                "id": entry_id,
+                "path": path,
+                "content_sha256": sha256_of_file(full),
+            }
+        )
+        paths.append(path)
+    return entries, paths
+
+
+def main():
+    with open(LOCK, encoding="utf-8") as f:
+        lock = json.load(f)
+    previous_by_path = {
+        e.get("path"): e for e in lock.get("entries", []) if isinstance(e, dict)
+    }
+
+    # 1) 全受控节扫描（hash 恒重算——幂等重锁语义：物料字节是身份源）。
+    scanned = []
+    scanned_paths = []
+    seen_ids = set()
+    per_section = {}
+    for section in SECTIONS:
+        entries, paths = scan_section(section)
+        per_section[section] = len(entries)
+        for entry in entries:
+            if entry["id"] in seen_ids:
+                raise SystemExit(f"[relock] catalog 物料 id 跨节重复: {entry['id']}")
+            seen_ids.add(entry["id"])
+            entry["source_ref"] = source_ref_for_path(
+                entry["path"], entry["id"], previous_by_path
+            )
+            scanned.append(entry)
+        scanned_paths.extend(paths)
+    scanned.sort(key=lambda e: e["id"])
+    scanned_paths.sort()
+
+    # 2) entries 全量重建 + controlled_children allowed/required 三方对齐
+    #   （batch-4 split-ledger 纪律；kernel relockCatalog 同口径）。
+    lock["entries"] = scanned
+    lock["controlled_children"]["allowed"] = list(scanned_paths)
+    lock["controlled_children"]["required"] = list(scanned_paths)
+
+    # 3) generated_by 注记（幂等追加；批次 1/2/2.6/3/4 各一记，历史留痕）。
+    for mark in (GENERATED_BY_MARK, GENERATED_BY_MARK_BATCH2, GENERATED_BY_MARK_BATCH26, GENERATED_BY_MARK_BATCH3, GENERATED_BY_MARK_BATCH4):
+        if mark not in lock.get("generated_by", ""):
+            lock["generated_by"] = lock.get("generated_by", "") + " + " + mark
+
+    with open(LOCK, "w", encoding="utf-8", newline="\n") as f:
+        json.dump(lock, f, ensure_ascii=False, indent=2)
+        f.write("\n")
+    sections_note = " ".join(f"{k}={v}" for k, v in per_section.items())
+    print(
+        f"relocked: entries={len(lock['entries'])} allowed={len(lock['controlled_children']['allowed'])} "
+        f"required={len(lock['controlled_children']['required'])} ({sections_note})"
+    )
+
+
+if __name__ == "__main__":
+    main()