pomaster 0.1.0

package/COMMERCIAL_LICENSE.md

@@ -0,0 +1,35 @@
+# POMaster Commercial License（商业授权说明）
+
+POMaster 采用**双许可**模式发布：
+
+1. **PolyForm Noncommercial 1.0.0**（默认公共许可，见根目录 [`LICENSE`](./LICENSE)）——仅在**非商业目的**下免费使用、修改与分发；
+2. **POMaster Commercial License**（本文件所述）——任何商业目的的使用需与版权所有者另行签署书面商业授权协议。
+
+两个许可互斥且不可叠加：未签署商业授权协议的，一律只受 PolyForm Noncommercial 1.0.0 约束。
+
+## 什么算商业使用？
+
+依据 PolyForm Noncommercial 1.0.0 的定义（Noncommercial Purposes / Personal Uses / Noncommercial Organizations 各节），以下情形**不在**公共许可覆盖范围内，需商业授权（举例非穷尽）：
+
+- 在营利性企业的**内部业务**中使用（企业内部业务运营、内部工具、内部平台）；
+- 中小企业 / 小微企业的任何商业性使用；
+- 将 POMaster 或其派生作品作为收费产品、付费服务、商业咨询交付物的一部分对外提供；
+- 以任何直接或间接营利为目的的使用。
+
+> **严格口径声明（Owner 决议 2026-09-01）**：内部商用与小企业商用均**不豁免**、不免费（即 `free_internal_business_use: false`、`free_small_business_use: false`）。上述两个豁免位如未来经 Owner 显式决定开启，将以本文件的正式修订版本公示，此前一律按严格口径执行。
+
+## 如何获得商业授权？
+
+商业授权需与版权所有者签署单独的书面协议，条款（范围、费用、期限、支持等）逐案议定。
+
+**联系方式**：allenxujianyang@outlook.com
+
+> 注：本文件为授权说明页，不是商业授权协议文本本身；实际商业授权以双方签署的协议为准。
+
+## 版权与署名
+
+Copyright (c) 2026 River-Singer。版权所有者如变更署名主体，以根目录 `LICENSE` 的 Required Notice 行为准。
+
+## 法律复核
+
+本项目许可章节不构成法律意见；正式公开发布或商业授权前，应由熟悉开源/软件许可的法律专业人士复核。

package/LICENSE

@@ -0,0 +1,83 @@
+Required Notice: Copyright (c) 2026 River-Singer
+
+---
+
+The above Required Notice line accompanies the software under the terms below.
+The license text that follows is the official PolyForm Noncommercial License 1.0.0,
+reproduced verbatim from <https://polyformproject.org/licenses/noncommercial/1.0.0>.
+
+---
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -0,0 +1,396 @@
+# POMaster
+
+> **AI 软件工程的 Governed Software State Control Plane。**
+> 管理系统当前可信状态、为每个 Agent 投影最小充分上下文、控制允许发生的变化、并要求一切变化被证据证明。
+
+[![CI](https://github.com/River-Singer/POMaster_VNext/actions/workflows/ci.yml/badge.svg)](https://github.com/River-Singer/POMaster_VNext/actions/workflows/ci.yml)
+[![License: PolyForm NC 1.0.0](https://img.shields.io/badge/License-PolyForm--NC--1.0.0-blue)](./LICENSE)
+
+```text
+POMaster = State + Context + Transition + Evidence，在 Authority 与 Adaptive Governance 下运行
+```
+
+## 快速上手
+
+POMaster 的全部能力收敛在一条 CLI（`pomaster`）——八拍 Change Loop 的每一拍都有对应命令面。先给一张**命令全景**（机器钉版，与 `pomaster --help` 零漂移；`#` 分节注释仅人读）。第一次使用？直接看下面 [install → init → 第一个 Change](#1-安装) 的全流程。
+
+```text
+# 0 BOOTSTRAP —— 建基线 / 速览 / 装眼睛 / 可移植性
+pomaster init
+pomaster status
+pomaster doctor
+pomaster portability bootstrap/check
+
+# ① TRIAGE —— 秒级判档（MINIMAL/LIGHT/STANDARD；NO-OP 合法）
+pomaster triage "<request>"
+
+# ② FRAMEWORK —— 许可签发/判卷/显式接管/台账
+pomaster permit issue/check/steal/list
+
+# ③ PROJECTION —— 最小充分上下文投影
+pomaster context compile/explain
+
+# ④ EXECUTE —— 写路径机器执行点 / 受控变更
+pomaster exec-guard --attempt <file|->
+pomaster maintain <change-or-task> --ops <tx>
+
+# ⑤ VERIFY —— FAST gate / gate recipes 派发 / 证据入账
+pomaster check --fast/--gates
+pomaster record gate-run/claim
+
+# ⑥ RECONCILE —— delta 三方对账 / 投影视图 / 审计 / 例外台账
+pomaster reconcile --permit <PERMIT.*>
+pomaster view blueprint/task
+pomaster audit blueprint/task
+pomaster ledger record/list
+
+# ⑦ COMPACT —— 折叠入账 / 知识生命周期 / 记忆收割
+pomaster compact
+pomaster knowledge search/inspect/record/review-candidates/promote/demote
+pomaster memory capture/inspect/harvest/review/promote/audit
+
+# ⑧ CARRY —— DoD 判卷收口
+pomaster closeout <task-id>
+
+# 横切 —— 对象检视 / Discovery / Research / Eval / Catalog / 迁移 / 生产反馈 / 多 Agent / 执行身份
+pomaster inspect <governed-id>
+pomaster brainstorm start/status/promote
+pomaster research list/inspect
+pomaster eval --suite behavioral
+pomaster catalog status/explain
+pomaster migrate trellis-spec --analyze --spec-root <dir>
+pomaster production band/evaluate/challenge/diagnose/metrics/self-improvement
+pomaster agents status
+pomaster run <task>
+pomaster handoff <task> --to <role>
+pomaster session attach/refresh/list
+pomaster lock acquire/heartbeat/release/steal/list
+pomaster execution begin/end/list
+pomaster trace show/list
+```
+
+### 1. 安装
+
+```bash
+# Node ≥ 22
+npm install -g pomaster        # 全局安装（推荐）
+# 或项目内：
+npm install --save-dev pomaster
+npx pomaster --help
+```
+
+### 2. 初始化治理基线：`pomaster init`
+
+在项目根执行（幂等——重复执行第二次起 NO_CHANGE，零字节写入；已存在的人类文件一律不覆盖）：
+
+```bash
+cd your-project
+pomaster init
+```
+
+它做四件事：
+
+| 产物 | 作用 | 会被覆盖吗 |
+|---|---|---|
+| `.pomaster/state/truth-index.json` | Canonical State 唯一事实源（空账本起点） | 否（存在即跳过；损坏显式报错，绝不静默重建） |
+| `.pomaster/state/authority.json` | Authority Map 骨架（默认登记 `BOOTSTRAP_OWNER`） | 否（人类加注的 owner 一律不动） |
+| `.pomaster/config.yaml` | 治理配置（人类可编辑） | 否（只在缺失时创建） |
+| `AGENTS.md` / `CLAUDE.md` | Agent 轻入口（profile + 状态速览 + 常用命令） | 仅带生成标记的（`CLAUDE.md` 通过 `@AGENTS.md` 导入共享） |
+
+### 3. init 之后该配置什么（config.yaml）
+
+```yaml
+version: 1
+profile: LIGHT            # 治理档位：MINIMAL | LIGHT | STANDARD
+triage:
+  ttl_hours: 168          # triage 结果有效期，过期必须 re-triage
+```
+
+**profile 三档怎么选**：
+
+| 档位 | 适合 | 体感 |
+|---|---|---|
+| `MINIMAL` | 脚手架/原型/个人实验 | 几乎感觉不到 POMaster（文案改动→一行 gate） |
+| `LIGHT`（默认） | 正常业务迭代 | 秒级判档 + FAST gate 内循环 + delta 审查 |
+| `STANDARD` | 核心链路/多角色协作 | 全 gate 矩阵 + 浏览器双通道证据 + 抽样复核 |
+
+**Authority（谁说了算）**：`.pomaster/state/authority.json` 默认单人形态（一切 authority 位置由项目 Owner 应答）；多人协作出现信号后再演化细粒度 owner——`owner_registry` 数组逐个登记即可，kernel 零配置变更。
+
+### 4. 第一个 Change：走一遍八拍
+
+```bash
+pomaster triage "给用户列表页加一个导出按钮"     # ① 秒级判档
+pomaster maintain <task> --phase pre-dev …       # ②③ permit 签发 + 上下文投影
+# ……在你的 Agent harness（Claude Code 等）里实现代码……
+pomaster check --fast                            # ⑤ FAST gate（BUILD 腿）
+pomaster closeout <task-id>                      # ⑧ DoD 判卷收口
+```
+
+### 5. 装齐眼睛（可选，按需）
+
+```bash
+pomaster doctor        # 工具/MCP 探测：缺什么提示装什么
+```
+
+doctor 探针覆盖：内核 / BUILD（tsc·eslint）/ CONTRACT（oasdiff·schemathesis）/ ARCHITECTURE（depcruise·import-linter）/ COVERAGE（c8·pytest-cov）/ MUTATION（mutmut·StrykerJS）/ SECURITY（gitleaks·pip-audit·semgrep）/ BROWSER（playwright·chrome-devtools MCP）/ PERFORMANCE（lighthouse·web-vitals）/ portability。**工具缺席=显式 NOT_RUN（非绿非红），绝不假绿**。
+
+---
+
+## 为什么存在（三行读完的来历）
+
+1. **旧模式治理的是文档**：把几百份 Markdown 规范播进项目、靠 Agent 自觉遵守——结果错误事实被继承放大（上个会话说"27 页开发完了"，实际半数是脚手架）、技术基线静默漂移、规范越堆越多直到没人看。
+2. **血泪换来的第一定律**：*报绿的治理工具比没有工具更危险——它把「未知」转换成「已验证干净」。* 所以本项目的核心不是"更多门禁"，而是**可信的证据**。
+3. **vNext 换掉治理对象**：不再治理文档，改为治理**状态本身**。文档只是状态的投影；事实必须带 Authority、Evidence 与完整生命周期。
+
+## 运行机制：State Control Plane
+
+POMaster 不是又一层 prompt 工程或 skill 包，而是一个**状态控制平面**——它把「软件项目当前可信的状态」作为一等公民管理起来：
+
+```mermaid
+flowchart TB
+  subgraph PLANE["POMaster State Control Plane（.pomaster/ store）"]
+    STATE["Canonical State<br/>truth-index + objects<br/>四轴状态"]:::core
+    PERMIT["Permit / Transition<br/>谁有权改什么"]:::core
+    EVI["Evidence 平面<br/>GRN / blobs / claims"]:::core
+    PROJ["Context Projection<br/>MUST/ADVISORY/KNOWLEDGE/<br/>CATALOG/LAZY TOOLS"]:::core
+  end
+  subgraph CAT["Engineering Catalog（随包分发）"]
+    POL["policies 79"]:::cat
+    KN["knowledge 10"]:::cat
+    GT["gates 5"]:::cat
+    SEN["sensors 6"]:::cat
+  end
+  AGENT["Agent Harness<br/>(Claude Code / Codex / …)"]:::ext
+  HUMAN["Human Authority<br/>(Owner)"]:::ext
+
+  HUMAN -- Authority 决议 --> PLANE
+  PLANE -- compile --> AGENT
+  AGENT -- maintain/record --> PLANE
+  CAT -- applicability 筛选 --> PROJ
+  EVI -- gate 判卷 --> STATE
+  classDef core fill:#e8f0fe,stroke:#1a73e8
+  classDef cat fill:#fef7e0,stroke:#f9ab00
+  classDef ext fill:#e6f4ea,stroke:#188038
+```
+
+三个关键设计：
+
+- **Canonical State 是唯一事实源**：一切对象（PAGE/CAPABILITY/CHANGE/TASK…）带四轴状态（lifecycle/confidence/evidence/change）+ Authority + 完整生命周期。Markdown 文档只是它的投影。
+- **Agent 不直接写状态**：一切写经 `maintain <id> --ops <tx>` 显式事务 → kernel `applyTransaction` 判卷（写路径机器执行点 `exec-guard` 判卷器非写入器）。
+- **证据先于结论**：gate 运行结果走 `record gate-run` 产 GRN 收据入 evidence 平面；claim 必须显式绑定 GRN 分母——「证据缺失伪装完成」会被 closeout 硬阻断。
+
+## SOP 编排：项目生命周期五段式
+
+```text
+0 BOOTSTRAP ──── init 扫描 / Authority Map / catalog-lock / 轻入口生成
+                  （有原型→活体走查提五件套；存量项目→纳管已有 registry/spec/记忆）
+1 主循环 ─────── N 次 Change，每次跑下面的八拍 Loop（项目的日常形态）
+2 周期事件 ────── 全量对账 / 紧缩 / 经验入库 / catalog 升级 diff / 自托管基准
+3 架构演化 ────── Challenge → ACR → 受控迁移 → Deviation 到期清算
+4 生产反馈 ────── SLO 击穿 → State Challenge → 新 Change（闭环）
+5 退役归档 ────── deprecation → retirement → history
+```
+
+### THE LOOP：每一次 Change 的八拍
+
+> **Agent 的 loop 在上下文窗口内收敛，POMaster 的 loop 在 git 仓库里收敛。**
+> 前者每圈归零，后者每圈复利。
+
+```text
+① TRIAGE      Router 判档（MINIMAL/LIGHT/STANDARD…）秒级分流；NO-OP 是合法成功
+② FRAMEWORK   ← 人唯一主场：只锁五件套（身份/Capability/契约引用/Permit范围/验收形状）
+                 条件接受即可开工，逐行签核制度已废除
+③ PROJECTION  最小充分上下文投影；经验按触发条件注入 ADVISORY 区
+④ EXECUTE     Permit 内实现免检；FAST gate 内循环自检；偏差走显式 Challenge
+⑤ VERIFY      确定性 Gate 判卷：四态判定+盲区计数+not-applicable 清点；
+               浏览器双通道证据（Playwright 断言 ∥ chrome-devtools 实时对账）
+⑥ RECONCILE   所见即所得：人只审 delta（框架偏离）/例外清单/抽样点
+⑦ COMPACT     Current Truth 更新或 NO_CHANGE；经验入账；任务归档
+⑧ → 下一轮    携带更准的 Truth 重进①——开局一次比一次便宜
+```
+
+### 八拍时序图（Agent 交互序列）
+
+```mermaid
+sequenceDiagram
+  autonumber
+  actor Owner
+  participant Agent as Agent (harness)
+  participant CLI as pomaster CLI
+  participant Kernel as kernel (store)
+  participant Gate as gauntlet legs
+  participant Ev as evidence 平面
+
+  Owner->>Agent: 描述意图 / task delta
+  Agent->>CLI: triage "<request>"
+  CLI->>Kernel: Router 判档（词表闭包）
+  Kernel-->>Agent: triage envelope（profile + TTL）
+  Agent->>CLI: maintain --phase pre-dev
+  CLI->>Kernel: permit issue + context compile
+  Kernel-->>Agent: PERMIT.* + 五分区 markdown（MUST/ADVISORY/…）
+  Note over Agent: Permit 范围内实现（免检）+ FAST gate 内循环
+  Agent->>CLI: check --fast / check --gates
+  CLI->>Gate: 派发 gate recipes
+  Gate->>Ev: GRN 收据逐条入账（四态判定）
+  Gate-->>Agent: verdict（passed/failed/not_run + 盲区计数）
+  Agent->>CLI: maintain --ops <tx> / compact
+  CLI->>Kernel: applyTransaction（判卷权威）
+  Agent->>CLI: closeout <task-id>
+  CLI->>Ev: DoD 判卷（claims×GRN 硬绑）
+  CLI-->>Owner: delta 审查面（人只看差异）
+```
+
+### 证据入账时序（防假绿的核心通路）
+
+```mermaid
+sequenceDiagram
+  autonumber
+  participant Runner as gate runner
+  participant Adapter as 腿 adapter
+  participant Store as kernel store
+  participant Blob as evidence blobs
+  Runner->>Adapter: gate recipe 派发
+  Adapter-->>Runner: 原始报告（官方词形）
+  Adapter->>Blob: persistEvidenceArtifact（内容寻址 sha256）
+  Blob-->>Adapter: artifact_ref
+  Adapter->>Store: record gate-run（GRN + artifact_refs）
+  Store->>Store: journal TX_APPLIED（ran_at_seq 锚）
+  Note over Store,Blob: 读侧 verifyEvidenceBinding：<br/>判卷字节 == 落盘字节 == GRN 引用字节<br/>失配 = EVIDENCE_BINDING_INCOMPLETE 判红
+```
+
+### 生产反馈时序（SLO 击穿闭环）
+
+```mermaid
+sequenceDiagram
+  autonumber
+  participant Prod as 生产监控
+  participant P as pomaster production
+  participant K as kernel store
+  Prod->>P: ControlBand 定义（谓词机校验，自由文本不存在）
+  P->>P: evaluate（三态：OK/BREACHED/NOT_EVALUABLE）
+  alt BREACHED
+    P->>K: evidence（detected_by=tool_signal）
+    P->>K: challenge → change 轴 CHALLENGED
+    P->>P: diagnose（三分类，必须引用 breach evidence）
+    P-->>Prod: 新 Change 进入主循环（闭环）
+  end
+```
+
+### Memory Harvest 时序（COMPATIBILITY 路线）
+
+```mermaid
+sequenceDiagram
+  autonumber
+  participant H as harness 自动记忆
+  participant M as pomaster memory
+  participant Inbox as inbox（PENDING）
+  participant Owner2 as Owner（batch review）
+  H->>M: harvest claude --harness-dir <dir>
+  M->>Inbox: 四桶初筛（TRUTH/KNOWLEDGE/EPISODE/PREFERENCE）
+  Owner2->>M: review --decide <id> --promote|--reject --note <必填>
+  M->>M: 分桶路由（KNOWLEDGE→恒 CANDIDATE+ADVISORY；TRUTH/DECISION/EVIDENCE→OWNER_ESCALATION）
+  M->>M: audit（MEMORY_DRIFT 探测 fail-closed）
+```
+
+## 类 Agent 架构
+
+POMaster 不内置 daemon，也不托管 Agent——它给「在 harness 里跑的主 Agent」提供状态平面 + 执行身份 + 观测器：
+
+```mermaid
+flowchart LR
+  subgraph HARNESS["Agent Harness（Claude Code / Codex / …）"]
+    MAIN["Main Agent<br/>（solo 直连形态）"]:::agent
+    SUB["Sub-agent / Role"]:::agent
+  end
+  subgraph POM["POMaster kernel"]
+    SESS["sessions（liveness 侧车）"]:::k
+    LOCK["locks（change/task/unit 三粒度互斥）"]:::k
+    AGX["Execution Identity（AGX-n）"]:::k
+    RT["AgentRuntime 契约<br/>（§58 四方法三探针）"]:::k
+  end
+  subgraph OBS["观测器（fail-closed 信号）"]
+    GK["DEF-GATEKEEPER<br/>分身漂移检测"]:::obs
+    SUP["DEF-SUP<br/>SOP 链触发观测"]:::obs
+  end
+  MAIN -- "begin/end execution" --> AGX
+  MAIN -- "attach/refresh" --> SESS
+  MAIN -- "acquire/heartbeat/steal" --> LOCK
+  SUB -- run/handoff（DEF-SUP 触发制，deferred） --> RT
+  AGX --> GK
+  SESS --> SUP
+  classDef agent fill:#e8f0fe,stroke:#1a73e8
+  classDef k fill:#fce8e6,stroke:#d93025
+  classDef obs fill:#fef7e0,stroke:#f9ab00
+```
+
+要点：
+
+- **Execution Identity ≠ Execution Trace ≠ Evidence**：AGX-n 是短小稳定的执行身份（runtime/model/permit 快照）；Trace 是行为侧车（writes/tool_receipts/evidence_refs，retention 四档）；Evidence 是可验证证明。三者分离（A19 美学）。
+- **Gatekeeper 防分身**：同一 execution 既提 proposal 又 ALLOW → drift 观测器亮灯——「系统永不自我批准」的机器面。
+- **托管编排受 DEF-SUP 触发制门槛**：solo 直连是默认形态；run/handoff 等 SOP 编排在触发条件（重复链/第二贡献者/headless-CI）出现前显式 deferred——治理开销与风险成比例（Minimum Sufficient Governance）。
+
+## 五原语：一切能力的唯一来源
+
+| 原语 | 回答的问题 |
+|---|---|
+| **Governed Object** | 系统里有什么值得长期识别的东西 |
+| **State**（四轴：lifecycle/confidence/evidence/change） | 它现在处于什么状态、可信到什么程度 |
+| **Context Projection** | 这个角色此刻应该看见什么 |
+| **Transition / Permit** | 谁有权、凭什么条件允许它变化 |
+| **Evidence** | 变化的证明由谁产出、如何防止假绿 |
+
+Spec、Task、Gate、Knowledge、Brainstorm……全部是这五个原语的派生视图。
+三个新一等公民对象族（从旧体系教训中诞生）：**分母 DENOMINATOR**（覆盖率的账本不许悄悄消失）、**键绑定 KEYBINDING**（治理 ID ↔ 代码路径的机器映射）、**producer 活性**（声明对象必须有人生产它）。
+
+## 哲学宪法（违者即是 bug）
+
+- Small Constitution：硬约束极少而精——不伪造事实、不越权、不静默冲突、不无证据宣称完成
+- No-op is elegant：没有必要的治理动作，零变化就是成功
+- Framework as Review Surface：框架约束好了的人，不需要读 AI 写的每一行代码——但前提是判卷器诚实，所以我们用对抗性用例持续攻击自己的 gate
+- Minimum Sufficient Governance：治理开销必须与变更风险成比例；小改动的体验是"几乎感觉不到 POMaster"
+- Memory Sovereignty：删掉本机缓存 + fresh clone + bootstrap ≈ 项目认知完全恢复
+
+## 命令面
+
+完整命令全景见上文 [快速上手](#快速上手)——那是机器钉版（与 `pomaster --help` 零漂移，CI golden 强制），此处不再重复抄写以避免漂移。每条命令的逐字说明用 `pomaster <组> --help` 查看；全部命令支持 `--json` 机读信封（§45），禁止彩色自然语言当机读接口。
+
+## 仓库蓝图（逻辑结构，物理上按需物化）
+
+```text
+packages/ kernel · cli · gauntlet-lite · schemas
+catalog/  policies(79) · knowledge(10) · gates(5) · sensors(6)
+tests/    unit · integration · golden · adversarial · behavioral · benchmarks
+benchmarks/ mutation-kill · constitutional · run-all（自托管三档基准）
+legal/    THIRD_PARTY_NOTICES · PROVENANCE · verify_notices
+```
+
+技术栈：TypeScript · Node ≥22 · pnpm monorepo · Canonical State 为 JSON · Git 为版本与回滚底座 · 外部测试工具一律走 Adapter（绝不进核心）。
+
+## 文档地图
+
+| 想了解 | 去哪里 |
+|---|---|
+| 产品需求全文（v0.4） | `doc/POMaster vNext/POMaster-vNext-PRD-v0.4.md` |
+| 增量 PRD v0.5.2（Agent Perception） | `doc/POMaster-vNext-PRD-v0.5.2-agent-perception.md` |
+| 增量 PRD v0.5.3（Grounded Brainstorm） | `doc/POMaster-vNext-PRD-v0.5.3-grounded-brainstorm-research.md` |
+| Kernel 公共 API 契约 | `docs/kernel-api.md`（本地） |
+| 设计研究资产 | `.trellis/tasks/*/research/`（本地） |
+
+## 质量承诺
+
+- 全量套件 3038 用例（六类齐全：单元/集成/Golden/对抗/行为/自托管基准），数量下限进 CI 棘轮强制执行（只升不降）
+- 任何已修缺陷类别必须先存在对应回归用例，才允许标注"结构性消灭"
+- CI 四腿（ubuntu/windows/macos/bootstrap-clean）+ mutation kill score 100%（changed-code scope）+ 三机器验证器（mutation --verify / notices / constitutional）
+
+## License
+
+POMaster 采用**双许可**发布（Owner 决议 2026-09-01）：
+
+- **PolyForm Noncommercial 1.0.0**（默认公共许可，仅授权非商业使用）：全文见 [`LICENSE`](./LICENSE)，官方标准文本逐字落盘；
+- **Commercial**（独立商业授权）：任何商业使用（含企业内部商用、小企业商用）均不在公共许可范围内、不豁免，需另行签署书面商业授权——说明见 [`COMMERCIAL_LICENSE.md`](./COMMERCIAL_LICENSE.md)。
+
+该组合为 source-available 双许可，不应宣传为 OSI Open Source。商标与项目标识归属见 [`TRADEMARKS.md`](./TRADEMARKS.md)；贡献授权条款见 [`CONTRIBUTING.md`](./CONTRIBUTING.md)；安全漏洞报告渠道见 [`SECURITY.md`](./SECURITY.md)；第三方依赖许可与 notice 义务见 [`legal/THIRD_PARTY_NOTICES.md`](./legal/THIRD_PARTY_NOTICES.md)。
+
+商业授权联系：TODO(Owner): 填联系邮箱/渠道
+
+> 正式公开发布前需完成法律专业人士复核。Trellis 仅作机制研究对照，零代码继承。

package/SECURITY.md

@@ -0,0 +1,22 @@
+# 安全政策（SECURITY）
+
+## 报告渠道
+
+发现安全漏洞请**勿**直接在公开 Issue / PR 中披露。
+
+请通过以下渠道私密报告：TODO(Owner): 填安全报告邮箱/渠道
+
+报告时请尽量附上：受影响组件与版本、复现步骤或 PoC、影响评估、（如有）修复建议。
+
+## 处理流程（简版）
+
+1. 收到报告后确认接收并评估；
+2. 修复开发与验证（必要时走本项目自身的八拍 Change Loop 与 gate 判卷）；
+3. 发布修复版本，并在公告中致谢报告者（除非要求匿名）。
+
+## 支持范围
+
+- 仓库内 `packages/`（kernel / cli / schemas / gauntlet-lite）及其发布物；
+- `scripts/` 与 `catalog/` 策展物料中的可执行内容。
+
+范围内的第三方依赖安全问题（如已知 CVE 影响）同样欢迎报告；依赖许可与 notice 义务见 [`legal/THIRD_PARTY_NOTICES.md`](./legal/THIRD_PARTY_NOTICES.md)。

package/TRADEMARKS.md

@@ -0,0 +1,12 @@
+# TRADEMARKS（商标与标识声明）
+
+**POMaster** 名称、POMaster logo 及其他项目标识（合称「项目标识」）归项目版权所有者所有。
+
+- 版权与许可主体署名见根目录 [`LICENSE`](./LICENSE) 的 Required Notice 行：Copyright (c) 2026 River-Singer。
+- Owner 署名主体占位：TODO(Owner): 如以法人/其他主体持有商标，在此补全法定主体名称。
+
+项目标识**不在** PolyForm Noncommercial 1.0.0 或商业授权协议的授权范围内；上述许可仅覆盖代码与文档等版权客体，不授予任何商标权。
+
+未经事先书面许可，不得在可能引起来源混淆的方式下使用项目标识。对 POMaster 原始代码的如实、指明来源的分发与描述性提及（nominative fair use）不在此限。
+
+**商标授权联系**：TODO(Owner): 填联系邮箱/渠道