@haiyangbg/buildbeat 2.0.2 → 3.0.0

package/example/contracts/PROTOCOL.md

@@ -1,38 +0,0 @@
-# 简账 跨边界契约 · PROTOCOL(SSOT)
-
-> **这是跨仓边界唯一的契约入口。** 谁改接口行为,先改这里;谁要接接口,先读这里。
-> 🔴 协议变更不照单全收——独立核查后再信,并在 §3 登记一行。本文件不含任何凭据明文。
-
-**契约快照对应版本:`v0.2.0`**(2026-06-20 上线)
-> 🔴 线上实况唯一查询口 = `bash scripts/bus-check.sh`;本行只标「本快照写就时对应的版本」。
-
-<!-- buildbeat-multirepo-map:v1
-repo=jz-web|contract=contracts/PROTOCOL.md|deployment=n/a
-repo=jz-api|contract=contracts/PROTOCOL.md|deployment=n/a
--->
-
----
-
-## 1. 当前契约快照
-
-### 边界:jz-web ↔ jz-api(REST,JSON)
-
-| 端点/字段 | 行为 | 备注 |
-|---|---|---|
-| `POST /api/entries` | 记一笔:`{amount, category, note?, ts}` → 201 | `amount` 一律**整数分**,前端负责展示为元 |
-| `GET /api/entries?month=YYYY-MM` | 当月流水,按 `ts` 倒序 | 分页二期再说 |
-| `GET /api/reports/monthly?month=YYYY-MM` | `{total, byCategory:[{category,sum}]}` | **按自然月**汇总(拍板 2026-06-12);空月返回 `{total:0, byCategory:[]}`,**不 404** |
-| 鉴权 | 单用户:`Authorization: Bearer <token>` | token 位置见 `ARCHITECTURE.md` §凭据 |
-| 错误 | `{error:{code,message}}` + 4xx/5xx | code 枚举:`INVALID_MONTH` / `UNAUTHORIZED` |
-
-## 2. 🔴 当前关键对齐点(开工前各域必须一致)
-
-1. 金额单位 = **分**(整数),序列化任何环节不得出现浮点——两端各有一条测试盯这条。
-2. 空月份返回空结构不 404——前端按"有数据/空数据"两态渲染,不做 404 分支。
-
-## 3. 契约变更记录(changelog · 倒序)
-
-| 版本 | 日期 | 变更 | 独立核查 |
-|---|---|---|---|
-| v0.2.0 | 2026-06-18 | 新增 `GET /api/reports/monthly`;定「空月返回空结构不 404」 | 测试域实测 `curl …?month=2026-01` → 200 + 空结构;读 `jz-web` Report 页确认无 404 分支,两端一致 |
-| v0.1.0 | 2026-06-13 | 首版:entries 两端点 + Bearer 鉴权 + 金额单位分 | reviewer 只读核两端代码,字段名/类型/错误码一致 |

package/example/pm/NOW.md

@@ -1,22 +0,0 @@
-# NOW — 当前冲刺指针(各工作包/AI 视角会话开工先读这里)
-
-> 本文件**永远只是薄指针**:当前期 + 看哪些文件,🔴 禁堆流水日志。
-> 🔴 线上版本不写在任何文档里:查 `bash scripts/bus-check.sh`。
-
-**当前期:一期(记账主流程 + 月度报表)**(已收尾:Gate4 已过、上线复核完,待换期)
-**本期轨道:标准轨**
-
-| 看哪 | 文件 |
-|---|---|
-| 🧭 当期看板 | `一期-看板.md` |
-| 🗳 拍板台账(决策单点) | `decisions.md` |
-| 🔌 契约 | `contracts/PROTOCOL.md` |
-| 📊 各 AI 视角状态(各写各的) | `status/产品.md` · `status/全栈.md` · `status/测试.md` |
-| 🔁 在途变更提案 | `changes/`(本期无提案,目录未建) |
-| 📦 历史期归档 | `archive/`(证据产物期中即写 `archive/一期/evidence/`;看板等文档换期时归档) |
-
----
-
-### 换期 checklist(当前工作包 Builder / 产品视角)—— 含压缩仪式
-
-> 与上游 NOW 模板的换期 checklist 一致,沙盘从略;二期立项时逐条执行。

package/example/pm/adr/ADR-0001-local-first-sqlite.md

@@ -1,25 +0,0 @@
-# ADR-0001: 账本采用本地优先 SQLite
-
-- Status: Accepted
-- Date: 2026-06-13
-- Superseded by: n/a
-
-## Context
-
-一期需要单用户快速记账、离线可用和低运维成本；当前没有多人实时协作或跨区域数据库需求。
-
-## Decision
-
-API 使用 SQLite 作为一期账本存储，金额以整数分保存；数据库文件仅由 API 服务拥有，Web 不直连。
-
-## Consequences
-
-部署和备份简单，但多实例写入能力受限。若进入多人实时协作或水平扩容，必须另建 ADR，不把 SQLite 直接外推为长期通用方案。
-
-## Alternatives considered
-
-PostgreSQL 能支持后续多实例，但一期运维成本与真实需求不匹配；浏览器本地存储无法满足服务端备份与 API 契约。
-
-## Related contracts / work packages / evidence
-
-一期记账主流程工作包；`contracts/PROTOCOL.md` 金额与账目字段；`pm/archive/一期/evidence/implementation.md`。

package/example/pm/adr/README.md

@@ -1,7 +0,0 @@
-# 简账 ADR 索引
-
-只有长期、难回退的技术决定进入本目录。普通产品拍板、Gate 确认和短期可逆选择继续记录在 `pm/decisions.md`。
-
-当前 ADR：
-
-- [ADR-0001：账本采用本地优先 SQLite](ADR-0001-local-first-sqlite.md)

package/example/pm/archive//344/270/200/346/234/237/evidence/gate1.md

@@ -1,5 +0,0 @@
-# Gate1 证据（沙盘）
-
-- 决策落点:`pm/decisions.md`
-- 验收结果:一期规格、范围与非目标已确认。
-- 边界:本文为虚构教学证据，不是真实项目或线上验收。

package/example/pm/archive//344/270/200/346/234/237/evidence/gate2.md

@@ -1,5 +0,0 @@
-# Gate2 证据（沙盘）
-
-- 决策落点:`pm/decisions.md`
-- 走查结果:柱状图与移动端单列方案按真渲染原型收敛。
-- 边界:沙盘不携带真实截图/原型，仅展示证据路径和可追溯格式。

package/example/pm/archive//344/270/200/346/234/237/evidence/gate3.md

@@ -1,5 +0,0 @@
-# Gate3 证据（沙盘）
-
-- 决策落点:`pm/decisions.md`
-- 候选结论:review-ready 条件齐备，milestone 与 P1 closure 已收敛。
-- 边界:本文不授权真实合并。

package/example/pm/archive//344/270/200/346/234/237/evidence/gate4.md

@@ -1,5 +0,0 @@
-# Gate4 证据（沙盘）
-
-- 决策落点:`pm/decisions.md`
-- 收尾结果:沙盘表达一期上线、L4 复核与挂账移交的文件形态。
-- 边界:这是虚构证据，不能外推为任何真实部署状态。

package/example/pm/archive//344/270/200/346/234/237/evidence/implementation.md

@@ -1,5 +0,0 @@
-# 实现候选证据（沙盘）
-
-- 范围:`jz-web` + `jz-api` + `contracts/PROTOCOL.md`。
-- 自动化:示意 E2E 12 例通过；candidate hash 见各 AI 视角 status。
-- 边界:example 中的 hash 为教学占位，不得引用为真实 L3 证据。

package/example/pm/decisions.md

@@ -1,20 +0,0 @@
-# decisions — 拍板台账(全工作区唯一决策单点)
-
-> **规则(总线⑨)**:一个真实决策包收敛后,第一动作 = 在此追加一行(倒序),再回写受影响的 SSOT;「回写」列没销完 = 欠账可见。验收条目与部分回答不单独记拍板。
-> v1.13 起新决策沿用看板收件箱包ID;历史行不追补编号。v1.14 起 reviewer 只在 review-ready 后启动。
-
-| 日期 | 拍板人 | 决策包 | 回写(落点 → 状态) |
-|---|---|---|---|
-| 2026-08-25 | 你 | 【FLOW-BUILDBEAT-RENAME】协作骨架品牌从 Solobaton 迁移为 BuildBeat；历史升级记录不回改，后续只写 canonical 新名 | BUILDBEAT.md / README / 产品 status → ✅；旧名行保留为历史 |
-| 2026-08-22 | 你 | 【FLOW-CLI-PREVIEW】升级 Solobaton v1.16:业务模板零替换;CLI v0 只读检查/规划,不允许写入、升级或卸载 | SOLOBATON.md / 产品 status → ✅;现有 Shell 护栏不变 |
-| 2026-08-22 | 你 | 【FLOW-UPSTREAM-TESTS】升级 Solobaton v1.15:替换 3 个路径健壮性脚本;上游 README/CI/测试不拷入业务项目;流程语义不变 | SOLOBATON.md / 产品 status → ✅;历史决策与看板不回改 |
-| 2026-08-22 | 你 | 【FLOW-REVIEW-READY】升级 Solobaton v1.14:候选满足 `HEAD=candidate`、干净、L3/渲染绿、无待修后才做一次 milestone;P0/P1 合并 closure;reviewer 静默返回 | AGENTS.md 规则⑥ / SOLOBATON.md / 一期-看板.md → ✅;历史报告不回改 |
-| 2026-08-22 | 你 | 【FLOW-20260822】升级 Solobaton v1.13:会话按工作包持续推进;审批分 STOP_NOW/BATCH_AT_GATE/NO_APPROVAL;决策包收敛后只记一次 | AGENTS.md §2.5 / SOLOBATON.md / 一期-看板.md / status 口径 → ✅;历史部分记录不回改 |
-| 2026-08-22 | 你 | 升级 Solobaton v1.12:机器闸常驻;高风险 delta 定向核;里程碑候选只全核一次;同一 hash 复用结论 | AGENTS.md 规则⑥ / SOLOBATON.md / 一期-看板.md 核查节奏 → ✅;历史报告不回改 |
-| 2026-06-20 | 你 | 一期验收通过,批准上线(⛔Gate4);报表导出 CSV 挪二期 | 一期-看板.md ⑤ → ✅;看板挂账 #1 → ✅ |
-| 2026-06-19 | 你 | ⛔Gate3 批准合并:月度报表(走查 P1「空月除零」已修复复验) | 一期-看板.md ⑤ 合并项 → ✅ |
-| 2026-06-15 | 你 | ⛔Gate2 真渲染过:报表用柱状图不用折线;移动端两列改单列 | design brief → ✅;一期-看板.md ② → ✅ |
-| 2026-06-13 | 你 | 【ADR-0001】一期账本采用本地优先 SQLite；多人实时协作或水平扩容时必须重开架构决策 | [ADR-0001](adr/ADR-0001-local-first-sqlite.md) / PROTOCOL.md / STACK.md → ✅ |
-| 2026-06-12 | 你 | 月度报表**按自然月**汇总,不做滚动 30 天 | PROTOCOL.md §1 → ✅ |
-| 2026-06-11 | 你 | ⛔Gate1 批准一期规格:记一笔 / 列表 / 月度报表;多币种不做 | 一期-看板.md → ✅ |
-| 2026-06-10 | 你 | Bootstrap 结论:两仓(jz-web / jz-api),同一 Builder 端到端负责,按需调用三种 AI 视角,标准轨 | AGENTS.md §1 → ✅ |

package/example/pm/status//344/272/247/345/223/201.md

@@ -1,20 +0,0 @@
-# 状态 · 产品
-
-> 只此域写,别人只读。倒序。hash 均为示意值(真项目必须可 `git cat-file` 核验)。
-
-## 当前基线
-
-- 一期已收尾,待换期;二期候选:报表导出 CSV、SQLite 每日备份(看板挂账)
-- 线上版本:查 bus-check(不写在这里)
-
-## 倒序日志
-
-- **2026-08-25** 工作包:协作骨架品牌迁移为 BuildBeat，canonical marker/文档入口完成换名，历史 Solobaton 记录保留 · 证据:decisions.md FLOW-BUILDBEAT-RENAME · ✅
-- **2026-08-22** 工作包:升级 Solobaton v1.16 CLI 生命周期预览 · candidate `meta e16c0de` · 证据:decisions.md FLOW-CLI-PREVIEW;模板零替换、写操作未开放 · ✅
-- **2026-08-22** 工作包:升级 Solobaton v1.15 仓库测试与路径健壮性补丁 · candidate `meta d15c0de` · 证据:decisions.md FLOW-UPSTREAM-TESTS;业务流程语义不变 · ✅
-- **2026-08-22** 工作包:升级 Solobaton v1.14 review-ready 与 reviewer 调用预算 · candidate `meta c14c0de` · 证据:decisions.md FLOW-REVIEW-READY + 一期-看板.md 核查口径 · ✅
-- **2026-08-22** 工作包:升级 Solobaton v1.13 任务/审批节奏并同步看板、决策与状态口径 · candidate `meta b13c0de` · 证据:decisions.md v1.13 行 + 一期-看板.md 工作包快照/决策收件箱 · ✅
-- **2026-08-22** 升级 Solobaton v1.12 核查节奏:高风险 delta 定向核 + 里程碑候选一次全核,历史不回改 · 证据:decisions.md 08-22 行 · ✅
-- **2026-06-20** 一期收尾记账:Gate4 拍板落台账、挂账 3 条移交看板 · 证据:decisions.md 06-20 行 · ✅
-- **2026-06-15** Gate2 组织真渲染走查,2 条修改意见拍板采纳 · 证据:decisions.md 06-15 行 · ✅
-- **2026-06-11** 一期立项:规格三条,Gate1 已批;设计 brief 已交(要求单 HTML 可渲染) · 证据:一期-看板.md 阶段① · ✅

package/example/pm/status//345/205/250/346/240/210.md

@@ -1,15 +0,0 @@
-# 状态 · 全栈
-
-> 只此域写,别人只读。倒序。hash 均为示意值(真项目必须可 `git cat-file` 核验)。
-
-## 当前基线
-
-- 两仓:jz-web(React + Vite)/ jz-api(Node + SQLite);部署见 ARCHITECTURE.md §2
-- 线上版本:查 bus-check(不写在这里)
-
-## 倒序日志
-
-- **2026-06-20** 部署 v0.2.0(两仓)+ 更新两仓 CHANGELOG · commit `jz-api a3f21c9` / `jz-web 7be04d2` · 证据:bus-check 线上实况 v0.2.0 · ✅
-- **2026-06-19** 修走查 P1:月报空月除零白屏 · commit `jz-web c91e77a` · 证据:`npx vitest run reports`(12/12)· ✅
-- **2026-06-18** 月度报表 API + 前端页,**契约先行**改 PROTOCOL v0.2.0 再动代码(规则②)· commit `jz-api 5d8b310` / `jz-web 2fa9c44` · 证据:PROTOCOL §3 v0.2.0 行 + 两端测试 · ✅
-- **2026-06-13** 记一笔 / 列表 两端点 + Bearer 鉴权(契约 v0.1.0) · commit `jz-api 9c07e12` / `jz-web e51ab08` · 证据:`curl` 实测 201/200 + 单测 · ✅

package/example/pm/status//346/265/213/350/257/225.md

@@ -1,15 +0,0 @@
-# 状态 · 测试
-
-> 只此域写,别人只读。倒序。
-
-## 当前基线
-
-- E2E:Playwright,12 例;证据产物:`pm/archive/一期/evidence/`(生成时即写归档位,换期零搬运;沙盘略)
-- 契约核查:两端独立核(不信全栈自述,规则②)
-
-## 倒序日志
-
-- **2026-06-19** 复验 P1 修复 + 全量回归:E2E 12/12 绿;一期候选 milestone 核查一次,P0/P1=0 · 证据:`npx playwright test` 报告 + 空月空态截图 · ✅
-- **2026-06-19** 月报走查发现 **P1:空月份页面白屏**(分类占比除零),带图提 bug · 证据:实现⟷设计稿并排截图(规则⑧,沙盘略) · ✅
-- **2026-06-18** 独立核契约两端:实测空月 `curl` 返回 200 空结构、读 Report 页无 404 分支,登记 PROTOCOL §3「独立核查」列 · ✅
-- **2026-06-15** Gate2 前真渲染走查:提折线图改柱状、移动端两列改单列,均被拍板采纳 · 证据:decisions.md 06-15 行 · ✅

package/example/pm//344/270/200/346/234/237-/347/234/213/346/235/277.md

@@ -1,97 +0,0 @@
-# 一期(记账主流程 + 月度报表) · 协调看板
-
-> 谁做什么、什么顺序、卡点在哪。工作包完成口径 = **用户级结果 + commit hash + 可核验证据**(核查门);子任务完成不等于会话结束。
-> 线上实况:`bash scripts/bus-check.sh`。拍板记 `decisions.md`。
-
-## 工作包快照(沙盘展示一期全程;live 看板只需保留在途 + 最近完成)
-
-> 简账由同一 Builder 端到端拥有一期工作包;产品/全栈/测试是该 Builder 调用的 AI 专业视角,不是三个人类岗位接力。
-
-### WP-1 · Gate2 候选
-
-- **objective**:把一期三条需求、契约和真渲染原型收敛到可拍板状态
-- **AI视角**:产品 / 测试(设计稿由外部工具交付)
-- **in_scope**:规格、契约、设计 brief、原型走查、Gate1/Gate2 决策包
-- **terminal_condition**:Gate2 真渲染拍板完成并留证据;或出现范围冲突
-- **状态**:✅完成(06-15)
-- **证据**:`pm/archive/一期/evidence/gate2.md`
-
-### WP-2 · 实现候选
-
-- **objective**:形成可测试的 jz-web + jz-api + 契约 v0.2.0 候选
-- **AI视角**:全栈
-- **in_scope**:一期三条需求实现、实现语义清单、受影响测试、两仓 CHANGELOG
-- **terminal_condition**:候选 hash 集和机器证据齐备;或出现冻结契约 delta
-- **状态**:✅完成(06-19)
-- **证据**:`pm/archive/一期/evidence/implementation.md`
-
-### WP-3 · Gate3 候选
-
-- **objective**:把实现候选验证到可合并状态
-- **AI视角**:测试 / 产品
-- **in_scope**:E2E 12 例、带图走查、review-ready 自检、一次 milestone reviewer、P0/P1 合并 closure
-- **terminal_condition**:两仓 `HEAD=candidate`、工作树干净、L3/渲染证据绿且无待修后一次核查,P0/P1 清零再提交 Gate3;或发现需修改冻结语义的真实阻塞
-- **状态**:✅完成(06-19)
-- **证据**:`pm/archive/一期/evidence/gate3.md`
-
-### WP-4 · 上线收尾
-
-- **objective**:完成受控上线、L4 复核与一期记账
-- **AI视角**:全栈 / 测试 / 产品
-- **in_scope**:Gate3 合并、部署、Gate4 上线、线上复核、挂账移交
-- **terminal_condition**:Gate4 后 L4 证据与状态/看板收尾完成;或部署前真实阻塞
-- **状态**:✅完成(06-20)
-- **证据**:`pm/archive/一期/evidence/gate4.md`
-
-> 每个工作包都覆盖多个需求 ID、文档、commit 或 reviewer 事件;子项完成只报中间进展,到用户级结果/Gate 候选才交接,没有让人反复说“继续”。
-
-## 决策收件箱
-
-| 包ID | 变量ID | 真实取舍 | 推荐值 + 理由 | 另一选择的后果 | 截止 Gate | 状态 |
-|---|---|---|---|---|---|---|
-| WP1-G1 | D1 | 月度统计周期 | 自然月,与账期一致 | 滚动 30 天更实时但难对账 | Gate1 | ✅ 06-12 已收敛 |
-| WP1-G2 | D1 | 报表图形 | 柱状图,真渲染下类别对比更清楚 | 折线更适合连续趋势,不适合本页类别比较 | Gate2 | ✅ 06-15 同包收敛 |
-| WP1-G2 | D2 | 移动端布局 | 单列,小屏信息不拥挤 | 双列信息密度高但卡片过窄 | Gate2 | ✅ 06-15 同包收敛 |
-
-> 验收清单的其余条目均由上述选择与契约推导,没有逐项要求人批。收敛结论只在 `decisions.md` 各记一次。
-
-## 阶段门
-
-- Gate1: passed | 决策: `pm/decisions.md:19` | 证据: `pm/archive/一期/evidence/gate1.md`
-- Gate2: passed | 决策: `pm/decisions.md:16` | 证据: `pm/archive/一期/evidence/gate2.md`
-- Gate3: passed | 决策: `pm/decisions.md:15` | 证据: `pm/archive/一期/evidence/gate3.md`
-- Gate4: passed | 决策: `pm/decisions.md:14` | 证据: `pm/archive/一期/evidence/gate4.md`
-
-> 四行机器令牌是 Gate 状态权威;下表是给人的阶段摘要。
-
-| 阶段 | 产出 | 负责 | 状态 |
-|---|---|---|---|
-| ① 需求(⛔Gate1 人批) | 一期规格:记一笔 / 列表 / 月度报表;多币种不做 | 产品 | ✅ 06-11 |
-| ② 设计(⛔Gate2 人对**真渲染原型**批) | `design/design_1期/`(沙盘略) | 外部设计工具 | ✅ 06-15(改 2 处:柱状图、移动端单列) |
-| ③ 实现 | jz-web + jz-api + 契约 v0.2.0 + 实现语义清单;机器闸每提交 | 全栈 | ✅ 06-19 |
-| ④ 验证 + 核查门 | review-ready 候选 hash 集 + E2E 12 例 + 带图走查 + milestone 一次 + P1 合并 closure 一次 | 测试 + 产品 | ✅ 06-19(P1 空月除零已修复复验) |
-| ⑤ 上线(⛔Gate3 合并 / ⛔Gate4 上线,人批) | 部署 + 两仓 CHANGELOG | 全栈 | ✅ 06-20 |
-
-## 能力视角表(需求 → 调用哪些 AI 视角)
-
-| 需求 | 全栈 | 测试 | 备注 |
-|---|---|---|---|
-| 记一笔 + 列表 | ★ | E2E+走查 | 契约 v0.1.0 |
-| 月度报表 | ★ | E2E+走查 | 按自然月(拍板 06-12) |
-
-## 🔴 关键对齐点(开工先定,别各做各的)
-
-1. 金额单位 = 分(整数)→ `contracts/PROTOCOL.md` §2
-2. 空月份返回空结构不 404 → PROTOCOL §1
-
-## 挂账(实时;工作包认领后各 AI 视角写回自己的 status,此处只改 ☐/✅)
-
-| # | 项 | 域 | 状态 | 依据/出处 |
-|---|---|---|---|---|
-| 1 | 报表导出 CSV → 移交二期 | 产品 | ✅(已入二期候选) | 拍板 06-20 |
-| 2 | SQLite 每日备份 | 全栈 | ☐ | ARCHITECTURE.md §2 |
-| 3 | 上线 7 天数据回看 | 产品 | ☐ | BuildBeat lessons 第 8 条 |
-
-## 验收口径
-
-对照一期规格三条 + 设计稿逐屏;两仓 `HEAD=candidate` 且干净;E2E 全绿;无已知待修后 milestone reviewer 无 P0/P1;真渲染走查含移动端与空月空态。同一候选 hash 在 Gate3 前复用该结论;reviewer 返回前 hash 变化则旧审查 `SUPERSEDED`,重新 review-ready 后再核。

package/example/standards/CODE.md

@@ -1,18 +0,0 @@
-# CODE.md — 简账代码与安全规范
-
-> **Optional**: 本文件由项目拥有；缺失时 BuildBeat 直接跳过，不作为告警或错误。
-> **AI write boundary**: 默认只读；普通需求、修构建或装依赖不得顺手改规范。
-> **Status**: Confirmed
-
-## Rules
-
-- `CODE-MUST-001`: Secret、真实账本、身份数据和生产配置值不得进入 Git、日志、测试夹具或证据。
-- `CODE-MUST-002`: API 输入先做 schema 校验；账目写入失败必须回滚，不返回伪成功。
-- `CODE-MUST-003`: 前后端共享字段变化先同步 `contracts/PROTOCOL.md`，再分别实现。
-- `CODE-MUST-004`: 新依赖必须提交 lockfile，并通过许可证与安全检查。
-- `CODE-SHOULD-001`: 金额在 API 与存储层使用整数分，界面边界才格式化为元。
-- `CODE-MAY-001`: 局部重构可随工作包完成，但不得趁机更换框架或持久化方案。
-
-## 项目禁止事项
-
-不得用浮点数持久化金额；不得在前端日志输出完整账目内容。

package/example/standards/DESIGN.md

@@ -1,34 +0,0 @@
-# DESIGN.md — 简账 UI / 视觉 / 交互规范
-
-> **Optional**: 仅有 UI、视觉或交互交付的项目按需创建；缺失时 BuildBeat 直接跳过，不作为告警或错误。
-> **AI write boundary**: 默认只读；普通页面实现不得顺手重写设计系统。
-> **Status**: Confirmed
-
-## Principles
-
-清晰、克制、账目优先；不用装饰性渐变掩盖信息层级。
-
-## Tokens
-
-字体、颜色、间距与圆角统一来自 jz-web 的 CSS variables；页面不得自建平行 token。
-
-## Components
-
-金额输入、账目行、月份选择器和空态组件优先复用；差异通过 props 或明确变体表达。
-
-## Interaction Patterns
-
-- `DESIGN-MUST-001`: 新增账目在 100ms 内给出按压或 loading 反馈，保存结果提供可访问确认。
-- `DESIGN-MUST-002`: 上线界面不得出现调试信息、实现说明、mock 标记或开发者元注释。
-
-## States
-
-- `DESIGN-MUST-003`: 账目列表和报表必须覆盖 loading、empty、error、disabled 与移动端状态。
-
-## Accessibility
-
-- `DESIGN-MUST-004`: 表单标签、键盘路径、焦点、图表替代文本和颜色对比进入真渲染走查。
-
-## Project-specific exceptions
-
-月度报表移动端使用单列柱状图；不复用桌面双列布局。

package/example/standards/REVIEW.md

@@ -1,16 +0,0 @@
-# REVIEW.md — 简账 Review 规范
-
-> **Optional**: 本文件由项目拥有；缺失时 BuildBeat 直接跳过，不作为告警或错误。
-> **AI write boundary**: 默认只读；只在项目 Review 口径被明确改变时修改。
-> **Status**: Confirmed
-
-## Rules
-
-- `REVIEW-MUST-001`: 逐项核对一期范围、非目标、错误态与金额口径，不以测试绿替代需求覆盖。
-- `REVIEW-MUST-002`: 核对跨仓契约、SQLite migration 与向后兼容边界。
-- `REVIEW-MUST-003`: 核对单元、API 集成、主流程 E2E、真渲染和 evidence 路径。
-- `REVIEW-MUST-004`: 核对输入校验、日志脱敏、账目持久化和回滚风险。
-- `REVIEW-SHOULD-001`: 拒绝无需求支撑的抽象、依赖或复杂状态层。
-- `REVIEW-SHOULD-002`: 确认看板、status、decisions 与同一候选一致。
-
-review-ready 与 reviewer 调用节奏仍以 `AGENTS.md` 为准。

package/example/standards/STACK.md

@@ -1,31 +0,0 @@
-# STACK.md — 简账技术栈约束
-
-> **Optional**: 本文件由项目拥有；缺失时 BuildBeat 直接跳过，不作为告警或错误。
-> **AI write boundary**: 默认只读；用户确认或明确要求技术栈变化后才可修改。
-> **Status**: Confirmed
-
-## 声明
-
-| 维度 | 项目约束 | 事实来源 |
-|---|---|---|
-| Runtime | Node.js 22 LTS | 两仓 package engines 与 CI |
-| 包管理器 | npm；各仓提交 package-lock.json | 两仓 lockfile |
-| 语言与框架 | React + TypeScript；Node.js API | 两仓 package.json 与源码入口 |
-| 数据设施 | SQLite 单机账本 | API schema 与 migration |
-| 部署 | Web/API 两个独立 PaaS 服务 | 部署配置与 `ARCHITECTURE.md` |
-| CI 与测试 | 单元、API 集成、主流程 E2E | 两仓 CI 与 verify-status suites |
-| 供应链 | MIT；依赖必须锁定并过安全检查 | LICENSE、lockfile、CI |
-
-## 可核对基线（bus-check v1）
-
-<!-- buildbeat-stack-baseline:v1
-nodeConstraint=22
-lockfileKind=package-lock.json
-dockerFromImage=n/a
--->
-
-## Rules
-
-- `STACK-MUST-001`: 声明与 package、lockfile、容器或部署配置冲突时只报告漂移，不自动选择一方。
-- `STACK-MUST-002`: 更换 Node、React、SQLite、包管理器或部署平台前必须建立 ADR，并同步 `contracts/PROTOCOL.md`。
-- `STACK-SHOULD-001`: 版本结论必须能回到仓库配置或运行平台证据。