@seasonkoh/webaz 0.1.26 → 0.1.28

package/LICENSE

@@ -3,9 +3,9 @@ Business Source License 1.1
   
   Parameters
 
-  Licensor:              seasonsagents-art
+  Licensor:              Holden
   Licensed Work:         WebAZ
-                         Copyright © 2026 seasonsagents-art and contributors
+                         Copyright © 2026 Holden and contributors
   Additional Use Grant:  You may make production use of the Licensed Work,
                          provided that your use does not include offering
                          the Licensed Work to third parties as a hosted or

package/NOTICE

@@ -1,7 +1,7 @@
 WebAZ — Licensing Notice
 =========================
 
-Copyright (c) 2026 seasonsagents-art and WebAZ contributors
+Copyright (c) 2026 Holden and WebAZ contributors
 
 
 Current License (since 2026-05-18)
@@ -10,7 +10,7 @@ Current License (since 2026-05-18)
 Business Source License 1.1 (BUSL-1.1).
 See LICENSE for full terms.
 
-  Licensor:              seasonsagents-art
+  Licensor:              Holden
   Licensed Work:         WebAZ — Agent-native decentralized commerce protocol
   Additional Use Grant:  You may make production use of the Licensed Work,
                          provided that your use does not include offering the
@@ -36,6 +36,26 @@ The license change applies only to commits and releases dated on or after
 2026-05-18.
 
 
+Pre-Genesis Authorship
+----------------------
+
+All pre-Genesis development of WebAZ was authored by Holden (GitHub:
+seasonsagents-art), the sole human contributor to the project during the
+pre-Genesis phase.
+
+This NOTICE records authorship and project history only. It does not constitute
+any claim of reward, valuation, governance rights, ownership percentage, or
+economic entitlement (RFC-017 §I-12).
+
+The complete pre-Genesis development history is preserved in the private
+webaz-archive repository.
+
+（创世前 WebAZ 的所有开发均由 Holden(GitHub:seasonsagents-art)完成,是创世前
+阶段项目的唯一【人类】贡献者。本声明仅记录作者归属与项目历史,不构成任何回报、
+估值、治理权、所有权份额或经济权利的主张(RFC-017 §I-12)。完整的创世前开发历史
+保留在私有 webaz-archive 仓库。）
+
+
 Third-Party Components
 ----------------------
 
@@ -47,7 +67,8 @@ package's LICENSE file for terms.
 Trademarks
 ----------
 
-"WebAZ" and the WebAZ logo are trademarks of seasonsagents-art. The license
+"WebAZ" and the WebAZ logo are unregistered (common-law) trademarks of Holden,
+to be assigned to the project's legal entity once one is formed. The license
 does not grant any trademark rights.
 
 

package/README.md

@@ -1,5 +1,6 @@
+**English** · **[中文](README.zh-CN.md)**
+
 > **Code is Rule, Protocol is Trust.**
-> **代码即规则，协议即信任。**
 > — webaz
 
 # WebAZ
@@ -8,392 +9,135 @@
 [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-active-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=webaz)
 [![License: BUSL-1.1](https://img.shields.io/badge/License-BUSL--1.1-orange.svg)](LICENSE) [![Change Date: 2030-05-18](https://img.shields.io/badge/Change%20Date-2030--05--18-blue.svg)](NOTICE) ![Status: Pre-launch](https://img.shields.io/badge/Status-Pre--launch-yellow.svg)
 
-> 🚧 **Pre-launch · 预发布阶段** — v1.0 公示中（起算 2026-05-31）· 0 真用户 · verifier + arbitrator 全为 fixture · 经济模型未结算 · 不建议生产使用。
-> 🚧 **Pre-launch stage** — v1.0 public-notice period (started 2026-05-31) · 0 real users · verifier + arbitrator are fixtures · economic model un-settled · **not for production use**.
->
-> 详见 / Details: [`docs/CHARTER.md`](docs/CHARTER.md) · [`docs/META-RULES-FULL.md`](docs/META-RULES-FULL.md) · [`docs/ECONOMIC-MODEL.md`](docs/ECONOMIC-MODEL.md) · [`/api/protocol-status`](https://webaz.xyz/api/protocol-status)
-
-让 AI Agent 成为去中心化商业协议的原生参与者。卖家零额外工作量接入新渠道，买家通过 Agent 自动购物，人类与 AI 在同一协议上平等参与。
-
-> 📖 **创始白皮书 / Founding Whitepaper** → [`docs/WHITEPAPER.zh-CN.md`](docs/WHITEPAPER.zh-CN.md) · [`docs/WHITEPAPER.md`](docs/WHITEPAPER.md)
+> 🚧 **Pre-launch** — v1.0 public-notice period (since 2026-05-31) · very early (genesis-phase accounts only) · verifier / arbitrator roles still being bootstrapped · economic model un-settled · **not for production use.**
 
-> ⭐ **运营哲学与远景** → [`docs/VISION-AND-OPERATIONS.md`](docs/VISION-AND-OPERATIONS.md)
-> COP（参与即建设，贡献可见）· 团队"消失"在协议里 · 最终全 DAO
+**WebAZ is an agent-native, decentralized commerce protocol.** Humans use a PWA; AI agents use an MCP server — both talk to the same backend under the same rules. Sellers plug existing catalogs into a new channel with zero extra work; buyers (or their agents) discover → price-lock → order → track autonomously; and escrow, fault attribution, and dispute resolution are enforced by **deterministic state machines, not a company's discretion.**
 
-> **试一下**：`npx -y @seasonkoh/webaz`，或在 Claude Desktop 加入 MCP 配置（见下）。
-> **PWA 演示**：[webaz.xyz](https://webaz.xyz)
+> 📖 Whitepaper → [EN](docs/WHITEPAPER.md) · [中文](docs/WHITEPAPER.zh-CN.md)  ·  🌐 Live PWA demo → **[webaz.xyz](https://webaz.xyz)**
 
 ---
 
-## 📜 授权说明
-
-自 **2026-05-18** 起，本项目使用 **Business Source License 1.1 (BUSL-1.1)** 协议发布。
-
-- ✅ 允许：内部使用、研究、二次开发、非竞争性商业使用
-- ❌ 禁止：运营与 WebAZ 实质相似的去中心化商业协议托管服务
-- ⏰ **2030-05-18** 之后，本协议自动转为 **MIT** 协议
-- 📦 **2026-05-18 之前**发布的所有版本（含历史 git 提交）仍持有 **MIT** 授权，不可撤销
-
-详见 [`LICENSE`](LICENSE) 与 [`NOTICE`](NOTICE)。
+## Why WebAZ exists
 
----
+AI agents are becoming primary economic actors, yet today's marketplaces are built for human clicks on closed platforms that extract rent and own the network. WebAZ is the opposite:
 
-## 核心特性
-
-### 协议骨架
-- **Agent 原生**：MCP 协议下，Claude 直接搜索、锁价、下单、举证、确认
-- **人类 + Agent 双轨**：PWA 给人类，MCP 给 Agent，共用同一后端
-- **协议级精准镜像**：q= 严格 exact match，"茶" 不会命中"茶具套装"；买家从外部平台复制的标识必须字面相等才返回结果（见 [intent-driven-buy](docs/modules/intent-driven-buy.md)）
-- **商品 alias 系统**：卖家声明 kouling_token / short_url / title_substring，让用户从外部平台的任何复制形式都能精准命中同一 SKU（见 [product-aliases](docs/modules/product-aliases.md)）
-- **角色感知 API**：`/api/products?mode=pwa|agent|raw` 三种调用方分级；agent 模式返回 score_breakdown，raw 模式 HMAC 签名（见 [products-api](docs/modules/products-api.md)）
-- **Agent Reputation 体系**：每个 api_key 独立 trust_score（4 layer band），raw mode 需 trust ≥ 30（见 [agent-reputation](docs/modules/agent-reputation.md)）
-
-### 多元交易场景
-- **🆕 多商家跟卖 (P1)**：listings 1:N offers，4 类目 stake 体系（standard 1.0× / general 1.5× / highvalue 2.0× / restricted 3.0× × base 50 WAZ）
-- **🆕 加权排序 + urgency 路由 (P2)**：trending score 含完成度/信誉/分享/点赞/新鲜度/季节性；urgency 三档 (now/today/flex) 路由不同 ETA 硬限
-- **🆕 RFQ 求购抢单 (P3)**：买家发求购，卖家限时报价；first_match 即时触发 / 提前结算 / 自然语言预填 / auto_bid Skill（见 [rfq-auction-chat](docs/modules/rfq-auction-chat.md)）
-- **🆕 加价拍卖 AUC**：English forward auction；反狙击 sniper_extend_min + max_extends cap；卖家担保金 5%
-- **🆕 P2P 原生商店**：无外链商品的去中心化路径；卖家本地节点存详情，WebAZ 锚定 hash + HMAC 签名 + 客户端 sha256 校验
-- **🆕 上下文绑定聊天**：order / RFQ / listing_qa 三类 chat；反诈正则检测微信号/电话/银行卡
-
-### 信任与合规
-- **claim 验证 + 条件订单**：买家可对推荐理由发起验证，3 verifier 共识仲裁，4 路径结算（pass / fail / no_fault / timeout）+ outlier 处罚（见 [claim-verification](docs/modules/claim-verification.md)）
-- **地区合规分润**：china/us/eu/india = 2 levels；其他 3 levels；UI 按地区动态显示
-- **零门槛上架**：卖家上架免质押，首单成交时从 escrow 自动锁 15% stake（trusted 卖家跳过）
-- **争议系统**：双方举证 → 仲裁员裁定 → 败诉方缴 1% 仲裁费（含超时自动判）
-- **链接认领验证**：卖家关联外部链接需通过众包验证码核验，防止他人冒用商品主权
-
-### 决策辅助
-- **🆕 价格历史 + 成交量分布**：3 窗口（30d/90d/lifetime） × 6 统计；价位分布 / sparkline / category_avg / anomaly_flags；防底价倾销
-- **结构化商品 + agent_summary**：规格 / 物流 / 售后字段拼成一句话决策摘要
-- **下单前价格锁定**：`webaz_verify_price` 返回 `session_token`，避免决策与下单之间价格漂移
-
-### 社会化 / 公益
-- **🆕 慈善许愿池**：双匿名（HMAC 派生 handle）+ 双签锚定（commit_hash）+ 反自圆梦封锁；许愿/圆梦/还愿/转捐 4 套荣誉细分（见 [charity](docs/modules/charity.md)）
-- **🆕 慈善基金**：还愿被谢绝自动转入；任何人可捐款（≤500 WAZ/愿，1 WAZ = 1 honor 上限 50/日）；公开账本 + 慈善家排行
-- **🆕 点赞 + 排行榜**：shareable_likes 防 Sybil；商品榜 (sales+推荐+点赞) + 创作者榜
-- **Skill 市场**：catalog_sync / auto_accept / instant_ship / auto_bid 等插件，Agent 订阅自动享用
-- **声誉 5 级**（新手 → 传奇）：影响质押折扣 + 搜索排名
-
-### 链上 / 安全
-- **链上托管**：USDC on Base Sepolia，充值地址按用户派生，自动扫归集 + 自动执行提现
-- **WebAuthn / Passkey** 大额操作闸门
-- **storage.persist()** 申请 + 持久化状态可视
-- **自动执法**：状态机责任归因，超时自动判责（每 5 分钟 cron 扫）
+- **Open protocol, not a platform.** The rules — parameters, consensus, arbitration — are public and verifiable. No company owns the network, and everything an agent does is auditable. An open, migratable protocol is structurally hostile to lock-in: you can always leave, so there is no rent to capture.
+- **Code is Rule.** Settlement splits, timeout fault-attribution, and dispute verdicts are deterministic state machines anyone can read — not a backend's private judgment.
+- **Humans and agents, first-class and equal.** The same protocol serves a person in a browser and an autonomous agent over MCP. An agent does the work; a real, accountable human stands behind it.
 
 ---
 
-## 快速开始
-
-> **自部署？** → 看 [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md)（30 分钟从零到上线 · systemd + Nginx + Let's Encrypt + 监控 + 备份完整 cookbook）
-> **环境变量？** → 复制 [`.env.example`](.env.example) 为 `.env` 填值
-
-### 方式一：Claude MCP 接入（Agent 原生体验）
-
-MCP server 有两种模式 / The MCP runs in one of two modes：
-
-| 模式 / Mode | 数据源 | 用途 | 如何触发 |
-|---|---|---|---|
-| 🟢 **NETWORK** | `webaz.xyz` 共享生产网络（带你的 `api_key`） | 真实加入网络、和别人交易 | 配了 `WEBAZ_API_KEY` |
-| 🟡 **SANDBOX** | 本机本地 SQLite（`~/.webaz/webaz.db`） | 离线试玩 / 开发，**与全网隔离** | 未配 `WEBAZ_API_KEY`（默认） |
-
-> 🟢 NETWORK = your agent acts on the live shared network. 🟡 SANDBOX = local-only, private to your machine, **not** the live network. Every tool result is stamped with `_mode` so you always know which one you're in.
+## Quickstart — 5 minutes
 
-**A. 先离线试玩（SANDBOX，零配置）**
+### A. Run it locally (new contributors)
 
-编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：
+It's a standard Node app with **no external services** (SQLite, in-process):
 
-```json
-{
-  "mcpServers": {
-    "webaz": {
-      "command": "npx",
-      "args": ["-y", "@seasonkoh/webaz"]
-    }
-  }
-}
+```bash
+git clone https://github.com/webaz-protocol/webaz.git
+cd webaz
+npm install
+npm run pwa          # → http://localhost:3000  (PWA + HTTP API + auto-enforcement cron)
 ```
 
-重启 Claude Desktop。`npx` 自动下载运行。此时所有数据都在本机沙盒，可放心试 `webaz_register` / `webaz_search` / 下单全流程。
+Open the PWA, register a local account, and walk a full order → ship → confirm → settle flow. **Before changing code, read [`AGENTS.md`](AGENTS.md)** — it explains the layered architecture and the house rules (especially around money/state-machine code).
 
-**B. 真正加入网络（NETWORK）**
+### B. Use it from an AI agent (MCP — any client)
 
-1. 在 [webaz.xyz](https://webaz.xyz) 注册账号（需邀请码；注册时绑定 Passkey 成为可问责真人）
-2. 「我的 / 设置」→ 复制 `api_key`
-3. 配置里加上 `WEBAZ_API_KEY` 环境变量：
+WebAZ ships an **MCP server**. MCP is an open standard, so it works with **any MCP-capable client** — Claude Desktop, Claude Code, Codex, Cursor, or your own agent. Add the server to your client's MCP config:
 
 ```json
-{
-  "mcpServers": {
-    "webaz": {
-      "command": "npx",
-      "args": ["-y", "@seasonkoh/webaz"],
-      "env": { "WEBAZ_API_KEY": "你的_api_key" }
-    }
-  }
-}
+{ "mcpServers": { "webaz": { "command": "npx", "args": ["-y", "@seasonkoh/webaz"] } } }
 ```
 
-> NETWORK 模式下 `webaz_register` **不自助建号**（账号必须由真人在 webaz.xyz 创建 + 绑 Passkey，这是协议的可问责性要求）。注册以外的交易工具——搜索 / 锁价 / 下单 / 上架 / 履约 / 查单——都直接在共享网络上跑。
+- 🟡 **Sandbox (default, zero-config):** with no `WEBAZ_API_KEY`, the agent runs against a **private local SQLite playground, isolated from the live network** — safe to try `webaz_register` / `webaz_search` / the whole order flow.
+- 🟢 **Network:** register at [webaz.xyz](https://webaz.xyz) (invite + Passkey = an accountable human), copy your `api_key`, and set it as `env.WEBAZ_API_KEY` → the agent acts on the **live shared network**. (On Network, `webaz_register` never self-creates an account — accounts require a real human + Passkey, by protocol.)
 
-**C. 开始使用**
+Every tool result is stamped with `_mode` so the agent always knows which network it's on. There are **38 tools**; ask `webaz_info` for the live list and params. A first prompt to try:
 
-在 Claude 对话里说：
-
-> "帮我在 WebAZ 搜索一下有什么商品，挑性价比高的下单"
-
-Claude 会自动调用 `webaz_search` → `webaz_verify_price` → `webaz_place_order` → `webaz_get_status` 完成发现→下单→追踪全流程。
+> *"Search WebAZ for products and order the best value one."* → the agent chains `webaz_search` → `webaz_verify_price` → `webaz_place_order` → `webaz_get_status`.
 
 ---
 
-### 方式二：PWA 浏览器界面
-
-```bash
-cd webaz
-npm run pwa
-# 打开 http://localhost:3000
-# 手机访问：http://<本机IP>:3000
-```
+## The contribution system (RFC-017)
 
-注册账号后即可使用完整功能。
+WebAZ records **who built what**, then lets the real person **claim** it — while promising **no reward**. This is how a stranger or an agent contributes and gets durable, verifiable credit.
 
----
+- **Record.** A merged GitHub PR is fetched and verified by WebAZ's *own authenticated read* (not self-reported) → an **immutable contribution fact** (executor = the agent / GitHub identity; accountable = a human).
+- **Claim — contribute first, bind later.** A contribution can be recorded against a GitHub identity *before* any account exists. The real person later binds a Passkey account by proving control of that GitHub identity (publish a one-time challenge marker in a gist → Passkey ceremony).
+- **The uncommitted-value boundary (I-12).** Contributions are accurately **recorded and claimable — that is the entire promise.** No reward, valuation, score, governance right, or ownership percentage is implied. *How* (or whether) contribution ever converts to value is deliberately deferred to a future DAO + legal/professional team. The commitment is *"your work is recorded and yours to claim,"* not *"you will be paid X."*
 
-## MCP 工具清单
-
-| 工具 | 说明 | 主要参数 |
-|------|------|----------|
-| `webaz_info` | 获取协议概览和实时统计 | — |
-| `webaz_register` | 注册账号，获取 api_key | `name`, `role` |
-| `webaz_search` | 搜索商品（结构化字段 + agent_summary + 声誉加权） | `query`, `category`, `max_price`, `min_return_days`, `max_handling_hours` |
-| `webaz_verify_price` | 下单前锁价 10 分钟，拿到 `session_token` | `product_id`, `quantity`, `api_key` |
-| `webaz_list_product` | 卖家上架商品（含品牌/规格/物流/售后字段） | `title`, `price`, `specs`, `handling_hours`, `return_days`, `api_key` |
-| `webaz_place_order` | 买家下单（可传 `session_token` 防价格漂移） | `product_id`, `shipping_address`, `session_token`, `api_key` |
-| `webaz_update_order` | 更新订单状态（接单/发货/确认/争议） | `order_id`, `action`, `api_key` |
-| `webaz_get_status` | 查询订单/钱包/争议详情 | `order_id` / `wallet` / `dispute_id`, `api_key` |
-| `webaz_wallet` | 钱包余额 + 链上充值地址 + 提现 | `action`, `api_key` |
-| `webaz_notifications` | 查询未读通知 | `api_key` |
-| `webaz_dispute` | 争议操作（查看/举证/裁定） | `action`, `api_key` |
-| `webaz_skill` | Skill 市场（发布/订阅；含 auto_bid） | `action`, `api_key` |
-| `webaz_profile` | 个人资料 + 多角色管理 | `action`, `api_key` |
-| `webaz_mykey` | api_key 恢复（已注册用户重新获取密钥） | `name`, `recovery_code` |
-| `webaz_rfq` | 🆕 RFQ 求购（发布/浏览/认领/详情） | `action`, `api_key` |
-| `webaz_bid` | 🆕 RFQ 报价（创建/修改/撤销/中标） | `action`, `rfq_id`, `api_key` |
-| `webaz_chat` | 🆕 上下文绑定聊天（order/rfq/listing_qa） | `action`, `context_id`, `api_key` |
-| `webaz_auto_bid` | 🆕 卖家自动报价 Skill 配置 | `action`, `api_key` |
-| `webaz_auction` | 🆕 加价拍卖（发起/浏览/出价/中标） | `action`, `api_key` |
-| `webaz_like` | 🆕 分享点赞（toggle/status） | `action`, `shareable_id`, `api_key` |
-| `webaz_leaderboard` | 🆕 排行榜（products / creators） | `kind`, `limit` |
-| `webaz_p2p_product` | 🆕 P2P 原生商店（卖家节点 hash 锚定） | `action`, `api_key` |
-| `webaz_price_history` | 🆕 商品历史成交价 + 价位分布 | `product_id` |
-| `webaz_charity` | 🆕 慈善许愿池 + 还愿 + 基金 + 捐款（11 sub-action） | `action`, `api_key` |
-
-完整协议规范（状态机/经济模型/争议规则）可通过 MCP Resource 读取：
-
-```
-webaz://protocol/manifest
-```
-
----
-
-## 角色说明
-
-| 角色 | 可以是人类或 Agent | 职责 |
-|------|-------------------|------|
-| `buyer` 买家 | ✅ 两者均可 | 浏览商品、下单、确认收货或发起争议 |
-| `seller` 卖家 | ✅ 两者均可 | 上架商品、接单、发货，可发布 Skill |
-| `logistics` 物流 | ✅ 两者均可 | 揽收、运输、投递，回传快递单号 |
-| `arbitrator` 仲裁员 | ✅ 两者均可 | 审查争议证据、做出裁定 |
-
----
-
-## 交易流程
-
-```
-买家下单（paid）
-  → 卖家接单（accepted）      ← 超时 24h：fault_seller
-  → 卖家发货（shipped）       ← 超时 72h：fault_seller（需选择物流公司）
-  → 物流揽收（picked_up）     ← 超时 48h：fault_logistics（回传快递单号）
-  → 运输中（in_transit）
-  → 投递完成（delivered）     ← 超时 48h：fault_logistics
-  → 买家确认（confirmed）     ← 超时 72h：自动确认
-  → 完成结算（completed）
-
-买家在 delivered 阶段可发起争议：
-  → 被告 48h 内举证 → 仲裁员 120h 内裁定
-  → 超时不回应：自动判发起方胜诉
-  → 败诉方缴纳订单金额 1% 仲裁费（最低 1 WAZ）
-  → 裁定结果：全额退款 / 释放给卖家 / 部分退款 / 责任分配
-```
+**Start here:** [`docs/PUBLIC-CONTRIBUTOR-ENTRY.md`](docs/PUBLIC-CONTRIBUTOR-ENTRY.md) · the `webaz_contribute` tool (browse/claim open tasks; agents welcome) · [`docs/AGENT-READY-TASK-SPEC.md`](docs/AGENT-READY-TASK-SPEC.md).
 
 ---
 
-## 资金分配
+## Governance-adjustable by design
 
-每笔成交按以下比例自动分配：
+WebAZ deliberately separates **principle** (permanent) from **mechanism** (tunable), so read every number here as *"today's default,"* not a fixed promise:
 
-| 接收方 | 比例 |
-|--------|------|
-| 卖家 | ~93%（扣除各项费用后） |
-| 物流方 | 5% |
-| 协议费 | 2% |
-| 推荐人（如有） | 3% |
+- Every rate, threshold, and weight — platform fee, commission split, stakes, region caps, … — is a **`protocol_params` value with a current default that DAO governance can change.** Some sit under constitutional hard caps (e.g. platform fee **≤ 2%, decrease-only**). Nothing economic is hard-coded as forever.
+- Money flows are fully parameterized and on-chain-auditable. The operator earns only an explicit platform fee + risk-event slashing — most of it rerouted to a public-good fund. Full walk-through: [`docs/ECONOMIC-MODEL.md`](docs/ECONOMIC-MODEL.md).
+- The constitution (meta-rules) and amendment thresholds live in [`docs/CHARTER.md`](docs/CHARTER.md) / [`docs/META-RULES-FULL.md`](docs/META-RULES-FULL.md).
 
-卖家上架**零质押**（M7.2.6 起）。首单成交时自动从订单 escrow 锁定 15% 作买家保护，
-信誉 ≥ trusted 的卖家直接跳过 stake 锁定（信任奖励）。
+> Matching rewards are disabled by default; PV / position is a participation record only — not income, not redeemable, no entitlement. See [`docs/REWARD-ENGINES-DECOUPLING.md`](docs/REWARD-ENGINES-DECOUPLING.md).
 
----
+**Fund split** (current `protocol_params` defaults, DAO-adjustable; 100-unit shop order):
 
-## 开发命令
-
-```bash
-npm run pwa          # 启动 WebAZ 服务（含自动执法，端口 3000）
-npm run mcp          # 单独启动 MCP Server（供 Claude Desktop 调用）
-npm run demo         # 跑完整交易演示脚本
-npm run test-dispute # 测试争议系统（三场景）
-npm run test-skill   # 测试 Skill 市场
-npm run test-rep     # 测试声誉系统
-npm run test-manifest# 测试协议 Manifest
-```
+| Recipient | Default | Notes |
+|---|---|---|
+| Seller | ~83% | net after the items below (residual) |
+| Share commission | 10% | to the referral chain L1/L2/L3 (default 7:2:1), region-capped; unclaimed → public reserve |
+| Logistics | 5% | 0 for self-fulfill / in-person |
+| Platform fee | 2% | 50% protocol reserve + 50% ops (secondhand 1%) |
+| Protocol fund | 1% | public-good / backstop; **pre-launch = 0** |
 
 ---
 
-## 技术栈
+## What's inside (feature map)
 
-| 方向 | 选择 |
-|------|------|
-| 运行时 | Node.js + TypeScript |
-| Agent 接口 | MCP (Model Context Protocol) |
-| 数据库 | SQLite（Phase 0），PostgreSQL（Phase 1+） |
-| 前端 | PWA — 手机浏览器直接访问，无需安装 |
-| 链（Phase 2） | 待定：Base / Optimism |
+- **Commerce:** catalog · escrow · transition-driven settlement · disputes + arbitration · verification tasks · RFQ · forward auctions · P2P listings · secondhand.
+- **Agent-native:** exact-match search · role-aware API (`?mode=pwa|agent|raw`) · per-`api_key` agent reputation · pre-order price-lock (`session_token`).
+- **Trust & compliance:** crowd-verified claim checks · region-aware commission caps · zero-stake listing (15%-default buyer-protection stake on first sale) · dispute system with timeout auto-judgment · link-ownership verification.
+- **On-chain & security:** USDC on Base (testnet live: Base Sepolia) · WebAuthn / Passkey gates on sensitive actions · automatic state-machine enforcement.
+- **Community:** dual-anonymous charity wishing pool + fund · leaderboards · skill market.
 
 ---
 
-## 架构总览 / Architecture map
-
-> 给 AI agent / 新贡献者:不用扫全仓,从下表对应层入手。改代码的 agent 请先读 [`AGENTS.md`](AGENTS.md)。
-> For AI agents / new contributors: don't scan the whole repo — start from the layer your change belongs to. Agents modifying code: read [`AGENTS.md`](AGENTS.md) first.
-
-一套代码两个运行时:**MCP server**(`src/mcp.ts`,给 AI agent)+ **PWA**(`src/pwa/`,给人类)—— 同后端、同规则。
-One codebase, two runtimes: the **MCP server** (for AI agents) and the **PWA** (for humans) share the same backend and rules.
+## Architecture (for code contributors)
 
-代码分 8 层(`src/layerN-*/`,由底向上依赖)/ Code is layered (`src/layerN-*/`, bottom-up):
+One codebase, two runtimes — the **MCP server** (for agents) and the **PWA** (for humans) share the same backend and rules. Code is layered bottom-up (`src/layerN-*/`):
 
-| Layer | 它是什么 / What |
+| Layer | What |
 |---|---|
-| `layer0-foundation` | DB schema · 订单**状态机** state-machine · manifest |
-| `layer1-agent` | **MCP server**(`L1-1-mcp-server/server.ts`，最常改)· 身份 / 外部锚点 identity / anchor |
-| `layer2-business` · `layer2-commerce` | 通知 / SNF / anchor registry 等业务 business logic |
-| `layer3-trust` | 争议引擎 dispute engine |
-| `layer4-economics` | 声誉 reputation · 技能市场 skill-market |
-| `layer5-decentralized` · `layer6-scale` | 治理 / 扩展(部分后续阶段)governance / scale (some reserved) |
-
-关键入口 / Key entry files:
-- `src/mcp.ts` → tools 实现在 `src/layer1-agent/L1-1-mcp-server/server.ts`
-- `src/pwa/server.ts` + `src/pwa/routes/` → PWA + HTTP API(人 / agent 共用生产端点)
-- `src/cron-enforcement.ts` → 协议自动判责执行(超时→处置)auto state-machine enforcement
+| `layer0-foundation` | DB schema · order **state machine** · manifest |
+| `layer1-agent` | **MCP server** (`L1-1-mcp-server/server.ts`) · identity / external anchors |
+| `layer2-business` · `layer2-commerce` | notifications · contribution (`L2-9-contribution`) · business logic |
+| `layer3-trust` · `layer4-economics` | dispute engine · reputation · skill market |
+| `layer5-decentralized` · `layer6-scale` | governance / scale (some reserved) |
+
+Key entries: `src/mcp.ts` → tools in `src/layer1-agent/L1-1-mcp-server/server.ts` · `src/pwa/server.ts` + `src/pwa/routes/` (PWA + HTTP API) · `src/cron-enforcement.ts` (timeout fault enforcement). **Agents modifying code: read [`AGENTS.md`](AGENTS.md) first.**
 
 ---
 
-## 当前阶段
+## License
 
-**Phase 0 · 概念验证** ✅
-**Phase 1 · 功能完善 + 链上 testnet 闭环** ✅
-- 14 个 MCP 工具 / 全角色 PWA / 通知 / 争议 / 声誉 / Skill 市场 / Manifest
-- USDC on Base Sepolia：派生充值地址、自动监听入账、热钱包扫归集、自动执行提现
-- 链接认领验证（众包验证码 + 主权流转）
-- Agent 决策三件套（结构化字段 / agent_summary / verify_price 锁价）
-- MCP 工具调用遥测（默认开，可关）
+**Business Source License 1.1** since 2026-05-18 (Licensor: Holden). Internal use, research, modification, and non-competing commercial use are permitted; operating a hosted service substantially similar to / competing with WebAZ is not. On **2030-05-18** it converts to **MIT**. All commits and releases dated **before 2026-05-18** remain **MIT, irrevocably**. See [`LICENSE`](LICENSE) · [`NOTICE`](NOTICE).
 
-**Phase 2 · 主网 + 真正去中心化**（下一步）
+**Pre-Genesis authorship:** all pre-Genesis development was authored by **Holden (GitHub: seasonsagents-art)**, the sole human contributor. This records authorship only — no reward / valuation / governance / ownership claim (RFC-017 §I-12). See [`NOTICE`](NOTICE).
 
 ---
 
-## 路线图
-
-### Phase 1 完成项
-- [x] 状态机 + 责任归因引擎
-- [x] MCP Server（14+ 个工具）
-- [x] 通知系统（SSE 实时推送）
-- [x] 争议系统（举证 + 超时自动裁定 + 仲裁费）
-- [x] 声誉积分体系（5 级）
-- [x] Skill 市场
-- [x] Protocol Manifest（机器可读协议规范）
-- [x] PWA 前端（全角色覆盖，人类 + Agent 双轨）
-- [x] 智能商品导入（贴链接自动提取）
-- [x] 链接认领验证（卖家主权 + 众包核验）
-- [x] 链上 USDC testnet 闭环（Base Sepolia）
-- [x] 下单前价格锁定（verify_price + session_token）
-- [x] 结构化商品规格 + agent_summary 决策摘要
-- [x] 遥测看板（/api/admin/usage）
-
-### M1-M7 协议级里程碑（2026-05 完成）
-- [x] **M1** 角色感知 API（mode=pwa/agent/raw）+ cursor 分页
-- [x] **M2** 基础排序公平（jitter / seller cap / 新人 slot）
-- [x] **M3** 反操纵层（click 去重 / 双轨同支审计 / 上架限速 / 注册 IP hash）
-- [x] **M4** Agent Reputation 体系（trust_score + raw mode 门槛 + HMAC 签名）
-- [x] **M5** 新人保护 + 阶梯新鲜度 + sort UI
-- [x] **M6** 商品类型 + 库存稀缺 + 季节性 lifecycle
-- [x] **M7.1** 智能下单 intent-driven UI 重做
-- [x] **M7.1.5** q= exact match 协议契约
-- [x] **M7.2** 商品 alias 系统（kouling_token / title_substring / short_url）
-- [x] **M7.2.5/6/7** 卖家 funnel + 地区合规（2/3 级分润）+ L3 区域感知
-- [x] **代码审计** H-1 / H-2 / M-1 / M-2 / M-5 / 3f254b8 完整批次
-- [x] **M7.3** claim 验证任务系统（4 路径结算 + outlier 处罚）
-- [x] **M7.4** 条件订单（has_pending_claim 暂缓自动判责）
-
-### P1-P3 多元交易场景（2026-05-18+）
-- [x] **P1** 多商家跟卖（listings + 4 类目 stake）
-- [x] **P2** 加权排序 + urgency 路由 + cold-start 衰减
-- [x] **P3 RFQ** 求购抢单 + bid_stake + first_match + auto_bid Skill + 买家 NLP Agent
-- [x] **CHAT** 上下文绑定聊天 + 反诈正则
-- [x] **AUC** 加价拍卖（English forward + 反狙击）
-- [x] **LIKE + Leaderboard** 分享点赞 + 商品/创作者双榜
-- [x] **P2P 原生商店** 卖家节点 hash 锚定 + HMAC 签名 + 客户端 sha256
-- [x] **Price History** 历史成交价 + 价位分布 + 异常预警
-
-### 慈善 + 社会化（2026-05-18 完成）
-- [x] **慈善许愿池** 双匿名 + 双签锚定 + 4 张表 + 6 前端页 + 反自圆梦封锁
-- [x] **还愿系统** 三态响应（accept / decline_to_fund / 7 天 auto-accept）
-- [x] **慈善基金** 单例池 + 任何人捐款 + 慈善家排行 + 公开账本
-- [x] **5 项荣誉细分**（repay/redirect/grace/donation_total/donation_honor）
-- [x] **16 项审计修复**（4 处竞态 + 6 项业务/隐私 + 6 项工程）
-
-### UX 重构（2026-05-19 完成）
-- [x] **导航重组** 角色化 tab bar（买家 5 / 卖家 5）
-- [x] **#me 私人 hub** 三段式（通用 6 / 角色专区 / 账户）
-- [x] **#discover 商务横条** 6 板块快捷入口（拍卖/求购/跟卖/P2P/排行/慈善）
-- [x] **i18n 双语全覆盖** 2700+ 条目；服务端按 Accept-Language 返回
-
-### 进行中 / 下一步
-- [ ] **跨模块审计收尾**（alias 限额 TOCTOU / settleOrder 原子化 / 杂项硬化）
-- [ ] **慈善基金 v2**：自动拨款机制（紧急医疗/教育大额匹配）+ 捐物（specific event 定向）
-- [ ] **导航 v2**：4 角色（logistics/verifier/arbitrator/admin）也加 #me 入口完整化
-
-### 长期
-- [ ] 链上 USDC 主网（Base）
-- [ ] IPFS 证据存储 + Pin Network（已搭骨架，留 P2）
-- [ ] 评价系统（结构化 1-5 星，反哺声誉）
-- [ ] 证据上传通道（争议附图）
-- [ ] 治理 DAO
-
----
+## Contact / Contributing
 
-## 联系 / Contact
-
-| 用途 / Purpose | Email | 详情 / Details |
+| Purpose | Email | Details |
 |---|---|---|
-| 通用咨询 / General inquiries | `contact@webaz.xyz` | — |
-| 安全漏洞 / Security vulnerabilities | `security@webaz.xyz` | [SECURITY.md](SECURITY.md) — 强烈优先用 [GitHub Security Advisory](https://github.com/seasonsagents-art/webaz/security/advisories) / Strongly prefer Advisory |
-| 行为准则举报 / Code of Conduct reports | `conduct@webaz.xyz` | [docs/CODE_OF_CONDUCT.md](docs/CODE_OF_CONDUCT.md) §7 |
-| BSL 商业授权 / Commercial licensing | `licensing@webaz.xyz` | [LICENSE](LICENSE) / [NOTICE](NOTICE) |
-
-> 📬 上述均为 Cloudflare Email Routing forwarding alias;phase A solo 阶段统一转发到创始人个人邮箱,响应水平为**个人级**(非企业 SLA);phase B+ 形成 maintainer 群后会切到团队 triage(无需改文档)。
-> 📬 All addresses are Cloudflare Email Routing forwarding aliases; in phase A solo, they route to the founder's personal inbox with **personal-level response** (not enterprise SLA); phase B+ will switch to maintainer team triage (no doc change needed).
+| General | `contact@webaz.xyz` | — |
+| Security | `security@webaz.xyz` | [SECURITY.md](SECURITY.md) — prefer a [GitHub Security Advisory](https://github.com/webaz-protocol/webaz/security/advisories) |
+| Code of Conduct | `conduct@webaz.xyz` | [docs/CODE_OF_CONDUCT.md](docs/CODE_OF_CONDUCT.md) §7 |
+| Commercial licensing | `licensing@webaz.xyz` | [LICENSE](LICENSE) / [NOTICE](NOTICE) |
 
-**Bug 报告 / 功能想法 / RFC**:走 [GitHub Issues](https://github.com/seasonsagents-art/webaz/issues) 或 [Discussions](https://github.com/seasonsagents-art/webaz/discussions);PR 流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+> Addresses are Cloudflare Email Routing aliases; in the current solo phase they reach the founder's inbox at **personal-level response** (not an enterprise SLA).
 
-**Bug reports / feature ideas / RFCs**: please use [GitHub Issues](https://github.com/seasonsagents-art/webaz/issues) or [Discussions](https://github.com/seasonsagents-art/webaz/discussions); PR workflow per [CONTRIBUTING.md](CONTRIBUTING.md).
+**Bugs / ideas / RFCs:** [Issues](https://github.com/webaz-protocol/webaz/issues) or [Discussions](https://github.com/webaz-protocol/webaz/discussions); PR workflow in [CONTRIBUTING.md](CONTRIBUTING.md). **New / GitHub-first / agent contributors:** [`docs/PUBLIC-CONTRIBUTOR-ENTRY.md`](docs/PUBLIC-CONTRIBUTOR-ENTRY.md).
 
-**新贡献者 / GitHub-first / 带 agent 的入口**:[`docs/PUBLIC-CONTRIBUTOR-ENTRY.md`](docs/PUBLIC-CONTRIBUTOR-ENTRY.md) — *contribute first, bind later*;贡献被记录但一切 `uncommitted`(不承诺奖励)。 / **New / GitHub-first / agent contributor entry**: [`docs/PUBLIC-CONTRIBUTOR-ENTRY.md`](docs/PUBLIC-CONTRIBUTOR-ENTRY.md).
+> 中文文档见 **[README.zh-CN.md](README.zh-CN.md)** — feature-by-feature detail, roadmap, and module docs.