@haiyangbg/buildbeat 3.0.0 → 3.0.1

package/example/src/export.js

@@ -0,0 +1,25 @@
+// CSV 导出（新地盘）。WORK-EXPORT-DATE-FILTER 给它加了 from / to 日期筛选。
+
+const HEADER = "date,category,amount,note";
+
+function escapeCell(value) {
+  const text = String(value ?? "");
+  return /[",\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+}
+
+// options.from / options.to 都是含端点的 "YYYY-MM-DD"；省略一端表示不限。
+export function exportCsv(ledger, options = {}) {
+  const { from, to } = options;
+  for (const bound of [from, to]) {
+    if (bound !== undefined && !/^\d{4}-\d{2}-\d{2}$/.test(bound)) {
+      throw new Error(`bad date bound: ${bound}`);
+    }
+  }
+  if (from && to && from > to) {
+    throw new Error(`from ${from} is after to ${to}`);
+  }
+  const rows = ledger
+    .filter((entry) => (from === undefined || entry.date >= from) && (to === undefined || entry.date <= to))
+    .map((entry) => [entry.date, entry.category, (entry.amount / 100).toFixed(2), entry.note].map(escapeCell).join(","));
+  return [HEADER, ...rows].join("\n") + "\n";
+}

package/example/src/ledger.js

@@ -0,0 +1,16 @@
+// 记账核心（老地盘：只维护，改动一律先问人）。
+// 一条流水 = { date: "YYYY-MM-DD", category, amount, note }；金额以分为单位的整数。
+
+export function addEntry(ledger, entry) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(entry.date)) {
+    throw new Error(`bad date: ${entry.date}`);
+  }
+  if (!Number.isInteger(entry.amount)) {
+    throw new Error("amount must be an integer number of cents");
+  }
+  return [...ledger, { note: "", ...entry }];
+}
+
+export function total(ledger) {
+  return ledger.reduce((sum, entry) => sum + entry.amount, 0);
+}

package/example/tests/export.test.js

@@ -0,0 +1,35 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { exportCsv } from "../src/export.js";
+import { addEntry } from "../src/ledger.js";
+
+const ledger = [
+  { date: "2026-08-30", category: "餐饮", amount: 3550, note: "" },
+  { date: "2026-09-01", category: "交通", amount: 1200, note: "地铁, 两程" },
+  { date: "2026-09-15", category: "房租", amount: 250000, note: "" },
+];
+
+test("exports every row with a header when no bounds are given", () => {
+  const csv = exportCsv(ledger);
+  const lines = csv.trimEnd().split("\n");
+  assert.equal(lines[0], "date,category,amount,note");
+  assert.equal(lines.length, 4);
+  assert.equal(lines[2], '2026-09-01,交通,12.00,"地铁, 两程"');
+});
+
+test("from / to bounds are inclusive and each side is optional", () => {
+  assert.equal(exportCsv(ledger, { from: "2026-09-01" }).trimEnd().split("\n").length, 3);
+  assert.equal(exportCsv(ledger, { to: "2026-09-01" }).trimEnd().split("\n").length, 3);
+  assert.equal(exportCsv(ledger, { from: "2026-09-01", to: "2026-09-01" }).trimEnd().split("\n").length, 2);
+  assert.equal(exportCsv(ledger, { from: "2026-10-01" }), "date,category,amount,note\n");
+});
+
+test("malformed or inverted bounds are rejected, not silently ignored", () => {
+  assert.throws(() => exportCsv(ledger, { from: "2026/09/01" }), /bad date bound/);
+  assert.throws(() => exportCsv(ledger, { from: "2026-09-02", to: "2026-09-01" }), /is after/);
+});
+
+test("ledger entries still validate their own date", () => {
+  assert.throws(() => addEntry([], { date: "bad", category: "x", amount: 1 }), /bad date/);
+});

package/example//346/214/207/346/214/245/345/217/260.md

@@ -0,0 +1,40 @@
+# 指挥台 — 简账：Builder 怎么驱动工作（忘了怎么开场就看这页）
+
+> 本仓运行 BuildBeat。会话按所用工具的方式装载 `AGENTS.md`（多数工具自动读根目录 `AGENTS.md` / `CLAUDE.md`；不自动读的，开场把它贴给会话）；活动工作在 `delivery/`。你基本只需说下面这几句话，命令由会话调、不用你手敲。
+
+## 日常六句话
+
+| 你想干什么 | 说什么 | 会话背后调什么 |
+|---|---|---|
+| 看现在到哪了、该谁动 | 「当前进度」/「待办是什么」 | `buildbeat overview --repo .`（每个 Work 的阶段 + 下一步）+ `observe status` |
+| 看有什么等我批 | 「有什么要我拍板」 | `buildbeat inbox --repo .`（每条附可复制的下一句） |
+| 立一件新事 | 「开个 Work：〔一句话目标〕」→ 看完说「接受」 | 建 `delivery/work/<ID>/intent.md + plan.md` → `accept`（digest 绑定） |
+| 让它干活 | 「开工」/「再来一轮」 | 先 `buildbeat doctor --config …`（配置、intent/plan 接受状态、env 姿态、预算），再 `start --config … --attempt new`（自动编号、自动作废旧等待，停在合并决定） |
+| 它是不是卡了 | 「怎么样了」/「卡住了吗」 | `buildbeat status --repo . --run <RUN>`（耗时、历史中位数、最后输出、STALLED） |
+| 拍板 | 「批准 / 拒绝〔RUN-ID〕」；分诊时「这条接受，那条不算」 | `approve` / `reject` / `findings adjudicate`；会话说清批的是哪一步（放行 fixer / 再跑一次 / 合并决定），非终态批准后 `resume` 续跑；合并决定只表示候选够格合并，合并/push/部署逐项另说 |
+
+其他：生产报警看 `delivery/observe/intents/` 草稿 → 「fix_now / schedule / dismiss」；上线用 `release-readback` 预设开一个 Run，「我做完了」就是批准 `enter-apply-readback`；「打扫卫生」= `gc --repo .`（先看计划再 `--apply true`）。
+
+## 新开一个 Work 时会话要动的文件
+
+`delivery/work/<WORK-ID>/`：`intent.md`（为什么 + 止损线）、`plan.md`（怎么做）、`run-config.yaml`（从 `templates/v2/run-config.example.yaml` 改 work / run / allowedPaths / workers）、`workflow.yaml`（从 `$(npm root -g)/@haiyangbg/buildbeat/src/v2/presets/software-delivery.yaml` 复制）。信封与 worker 包装在仓级 `delivery/envelope/`，不用每个 Work 重写。
+
+## 视角开场白
+
+| AI 视角 | 在哪开（cwd） | 你的一句话 |
+|---|---|---|
+| **产品** | 工作区根 | 「把当前目标收成一个 Work」/「验收」——定 intent/plan、维护决策收件箱、按决策包记 `pm/decisions.md` |
+| **全栈** | `<代码仓>/` | 「〔WORK-ID〕该你了，开工」——授权范围内实现，Run 停在合并决定回人批 |
+| **测试** | 工作区根 | 「验〔RUN-ID〕候选」——对精确 candidate 独立核验，报告落所属 Work 目录 |
+
+## 域回复怎么写
+
+面向你收口统一「已做 → 未做 → 下一步」，各一句；证据紧跟事项。下一步只写一条：下一棒是谁、需要你确认什么、或「我继续做，暂不交棒」。
+
+## 按项目阶段的完整问法
+
+未开始 → 立项定方案 → 准备执行 → 执行推进 → 验收合并 → 上线 → 完结换期复盘，每阶段说什么、会话做什么、你得到什么：见 BuildBeat 指南第 0 篇 `docs/v2/guide/00-how-to-talk.md`（Skill 装载目录下同路径）。
+
+## 红线、写边界、审批三级、可见命名进决策卡
+
+全在 `AGENTS.md`，本页不复制。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haiyangbg/buildbeat",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "BuildBeat: Git-based AI delivery across models, tools, sessions, and people, with context in project files, build-test-review-fix loops, and human decisions.",
   "type": "module",
   "bin": {
@@ -22,6 +22,7 @@
     "!docs/PHASE*.md",
     "!docs/CLI-STRATEGY-2026-08.md",
     "!docs/CLI-PILOT-2026-08-23.md",
+    "example/",
     "src/",
     "templates/",
     "CHANGELOG.md",