@bolloon/bolloon-agent 0.4.33 → 0.5.1

package/dist/agents/mobile-task-actions-verify.js

@@ -0,0 +1,74 @@
+/**
+ * mobile-task-actions-verify.ts — 桌面端**验签**实现 (2026-09-25)
+ *
+ * 与 `contacts/grants.ts::verifyGrantSignature` 同一套纪律 (同一批已登记设备公钥, 同样逐项给理由):
+ *   形状 → 设备已登记 → payloadHash 对得上 → Ed25519 真验签 → 时效 → 内容摘要对得上。
+ *
+ * 为什么内容摘要要**桌面重算**: 手机签的是 "kind + 规范化内容" 的摘要。桌面在执行前用**请求里的原始字段**
+ * 重算一遍, 于是签名天然绑定了"要执行的那件事"本身 —— 既不能换类型 (入群签名拿去发公告),
+ * 也不能换内容 (换群/换正文/换公告号)。
+ *
+ * node 侧实现 (crypto.verify) 与手机 WebCrypto 签名对得上, 因为**规范载荷用的是同一份纯函数**。
+ */
+import * as crypto from 'crypto';
+import { canonicalTaskActionPayload, taskActionContentText, checkTaskActionShape, checkTaskActionFreshness, actionKindAllowsRequest, TASK_ACTION_TTL_MS, } from './mobile-task-actions.js';
+/** sha256(规范化动作内容) —— 与手机侧 crypto.subtle.digest('SHA-256', …) 同值 */
+export function contentDigestOf(req) {
+    return crypto.createHash('sha256').update(taskActionContentText(req), 'utf8').digest('hex');
+}
+/** sha256(规范载荷) —— 与手机侧 payloadHash 同值 */
+export function payloadHashOf(a) {
+    return crypto.createHash('sha256').update(canonicalTaskActionPayload(a), 'utf8').digest('hex');
+}
+/**
+ * 完整验签 (桌面路由唯一入口)。
+ *
+ * @param input   手机请求里的 { action, signature }
+ * @param pub     已登记设备公钥 (按 action.deviceId 查; 查不到传 null)
+ * @param opts.req      桌面准备执行的业务字段 → 重算内容摘要比对 (不传 = 跳过内容比对, 只有明确不需要时才这样用)
+ * @param opts.now      当前时间 (测试注入)
+ */
+export function verifyTaskAction(input, pub, opts = {}) {
+    const shape = checkTaskActionShape(input);
+    if (!shape.ok)
+        return { ok: false, reason: shape.reason, message: `动作载荷形状不合法: ${shape.reason}` };
+    const action = shape.action;
+    const signature = input?.signature;
+    if (!signature || !signature.sig)
+        return { ok: false, reason: 'unsigned', message: '动作没有签名 (桌面拒收未签名的手机动作)' };
+    if (!pub)
+        return { ok: false, reason: 'unknown_device', message: `未知设备 ${action.deviceId} (先在桌面登记这台手机的公钥)` };
+    if (pub.deviceId !== action.deviceId || signature.deviceId !== action.deviceId) {
+        return { ok: false, reason: 'device_mismatch', message: '签名设备与载荷设备不一致' };
+    }
+    if (signature.alg !== 'ed25519')
+        return { ok: false, reason: 'bad_signature', message: `签名算法不是 ed25519: ${String(signature.alg)}` };
+    const payload = canonicalTaskActionPayload(action);
+    if (signature.payloadHash && signature.payloadHash !== payloadHashOf(action)) {
+        return { ok: false, reason: 'payload_tampered', message: '载荷哈希对不上 (动作在签名后被改过)' };
+    }
+    try {
+        const ok = crypto.verify(null, Buffer.from(payload, 'utf8'), crypto.createPublicKey(String(pub.publicKeyPem)), Buffer.from(String(signature.sig), 'base64'));
+        if (!ok)
+            return { ok: false, reason: 'bad_signature', message: '设备签名验不过 (不是这台设备签的, 或载荷被改过)' };
+    }
+    catch (err) {
+        return { ok: false, reason: 'verify_error', message: `验签抛出: ${String(err?.message || err).slice(0, 120)}` };
+    }
+    const fresh = checkTaskActionFreshness(action, opts.now ?? Date.now());
+    if (!fresh.ok)
+        return { ok: false, reason: fresh.reason, message: `动作时效不合法: ${fresh.reason} (TTL 上限 ${TASK_ACTION_TTL_MS / 60000} 分钟)` };
+    if (opts.req) {
+        if (String(opts.req.kind) !== action.kind) {
+            return { ok: false, reason: 'kind_mismatch', message: `请求类型 (${opts.req.kind}) 与签名动作类型 (${action.kind}) 不一致` };
+        }
+        const kindOk = actionKindAllowsRequest(action.kind, opts.req);
+        if (!kindOk.ok)
+            return { ok: false, reason: 'kind_shape_mismatch', message: kindOk.error || '动作类型与请求字段不匹配' };
+        const expect = contentDigestOf(opts.req);
+        if (expect !== action.contentDigest) {
+            return { ok: false, reason: 'content_mismatch', message: '内容摘要对不上: 签名绑定的不是你这次要执行的内容' };
+        }
+    }
+    return { ok: true, action };
+}

package/dist/agents/mobile-task-actions.js

@@ -0,0 +1,178 @@
+/**
+ * mobile-task-actions.ts — 手机端**高风险任务动作**的授权载荷 (单一规范, 2026-09-25)
+ *
+ * 为什么需要它: 手机新增的四项能力里, 有三个是**会对外产生后果**的动作 ——
+ *   入群 (让本机进入一个公开 store) · 发任务公告 (把公告发进群 / 往注册表公告) · 过程留痕 (接单/交付/初筛/终审)。
+ * 这些动作**不能**只凭"手机发了个 HTTP 请求"就执行: 任何能碰到桌面的本地进程都能伪造这样一个请求。
+ * 所以沿用联系方式授权已有的那套纪律 (contacts/grant-payload.ts + mobile-contacts.ts):
+ *   **手机展示待发内容 → 用户确认 → 设备私钥 (Ed25519) 签一条规范载荷 → 桌面验签后才执行**。
+ *
+ * 本文件只放**纯函数与类型** (无 node: 导入), 理由与 grant-payload 相同:
+ * 手机 (WebCrypto) 与桌面 (Node crypto) 必须对同一条动作算出**同一个字节串**, 否则签名永远验不过。
+ *
+ * 三条不可回退的性质:
+ *   1. **绑定内容**: 载荷里带 `contentDigest` = sha256(规范化后的动作内容)。桌面在执行前**自己重算一遍**,
+ *      对不上就拒 —— 签名对"入群"有效, 就不能被换成一个"发公告"的请求 (类型绑定), 也不能被换内容。
+ *   2. **短时效**: `expiresAt - createdAt ≤ TASK_ACTION_TTL_MS`。一张"很久以后还能用"的空白批准等于没有批准。
+ *   3. **不带私钥材料**: 载荷里只有 deviceId + 摘要 + 时间, 永远不含私钥/明文。
+ *
+ * 桌面侧验签实现见 `mobile-task-actions-verify.ts` (node crypto); 手机侧签名见 `src/web/mobile-tasks.ts`。
+ */
+/** 手机可发起的高风险任务动作 (闭集; 每一项都必须走签名纪律) */
+export const MOBILE_TASK_ACTION_KINDS = [
+    'group_join', // 入群 (加入一个 OrbitDB 群 store)
+    'group_leave', // 退群
+    'group_create', // 建群 (会自动入群)
+    'announce_publish', // 发布任务公告 (落盘公告 + 向注册表公告 + 记脉冲)
+    'announce_to_group', // 把板上的公告推进群里 (CLI: bolloon task announce)
+    'trail_post', // 过程留痕: 接单/交付/初筛/终审 (CLI: bolloon task post)
+];
+/** 参与签名的字段 (顺序即规范顺序, 改动等于换协议版本) */
+export const TASK_ACTION_SIGNED_FIELDS = [
+    'actionId', 'kind', 'deviceId', 'ownerDid', 'targetRef', 'contentDigest',
+    'createdAt', 'expiresAt', 'grantedBy', 'via',
+];
+/** 动作是干什么的 (人话) —— 手机确认页与桌面错误信息共用 */
+export const TASK_ACTION_LABELS = {
+    group_join: { zh: '加入这个群', en: 'Join this group' },
+    group_leave: { zh: '退出这个群', en: 'Leave this group' },
+    group_create: { zh: '建一个新群', en: 'Create a new group' },
+    announce_publish: { zh: '发布任务公告', en: 'Publish a task announcement' },
+    announce_to_group: { zh: '把这条公告发进群', en: 'Post this announcement into the group' },
+    trail_post: { zh: '往群里留一条过程痕迹', en: 'Post a process trail entry into the group' },
+};
+/** 动作的时效上限 (10 分钟)。超过 = 拒 (长命批准 = 没有批准) */
+export const TASK_ACTION_TTL_MS = 10 * 60_000;
+/** 手机侧默认签多长 (5 分钟): 够用户点一下, 又不会留下一张长期通行证 */
+export const TASK_ACTION_DEFAULT_TTL_MS = 5 * 60_000;
+/** createdAt 允许的时钟偏移 (桌面/手机不是同一块表) */
+export const TASK_ACTION_CLOCK_SKEW_MS = 2 * 60_000;
+/** 空值一律折成 `-` 并转义分隔符, 保证同一份请求算出的文本**逐字节稳定** */
+function tok(v) {
+    if (v === null || v === undefined)
+        return '-';
+    const s = String(v);
+    if (!s)
+        return '-';
+    // 换行会破坏"一行一字段"的稳定性 (也不该出现在摘要输入里)
+    return s.replace(/\r?\n/g, '\\n');
+}
+/**
+ * 规范化动作内容 (唯一实现; 手机与桌面都调它, 再各自做 sha256)。
+ * 字段顺序固定 —— 顺序变了等于换协议。
+ */
+export function taskActionContentText(req) {
+    const kind = String(req?.kind ?? '');
+    const base = [
+        `kind=${tok(kind)}`,
+        `group=${tok(req?.groupRef)}`,
+        `ann=${tok(req?.announcementId)}`,
+    ];
+    if (kind === 'announce_publish') {
+        base.push(`cap=${tok(req?.capability)}`);
+        base.push(`budget=${tok(req?.budgetHuman)}${req?.currency ? `@${tok(req.currency)}` : ''}`);
+        base.push(`deadline=${tok(req?.deadline)}`);
+        base.push(`instruction=${tok(req?.instruction)}`);
+    }
+    else if (kind === 'announce_to_group') {
+        base.push(`criteria=${tok(req?.criteria)}`);
+    }
+    else if (kind === 'trail_post') {
+        base.push(`trail=${tok(req?.trailKind)}`);
+        base.push(`round=${tok(req?.round)}`);
+        base.push(`price=${tok(req?.price)}`);
+        base.push(`hash=${tok(req?.hash)}`);
+        base.push(`bytes=${tok(req?.bytes)}`);
+        base.push(`checks=${tok(req?.checks)}`);
+        base.push(`verdict=${tok(req?.verdict)}`);
+    }
+    return base.join('\n');
+}
+/**
+ * 规范载荷 (逐字节稳定: 显式字段序 + 空值折 `''`, 不含 signature 自身)。
+ * 与 `canonicalGrantPayload` 同风格 —— 两端算出的字节串必须完全一致。
+ */
+export function canonicalTaskActionPayload(a) {
+    return JSON.stringify({
+        actionId: a.actionId, kind: a.kind, deviceId: a.deviceId, ownerDid: a.ownerDid,
+        targetRef: a.targetRef || '', contentDigest: a.contentDigest,
+        createdAt: a.createdAt, expiresAt: a.expiresAt, grantedBy: a.grantedBy, via: a.via,
+    });
+}
+/** 动作 id 形状 (幂等/追溯用; 不含任何身份材料) */
+export function isTaskActionId(id) {
+    return /^act-[A-Za-z0-9._-]{4,64}$/.test(String(id || '').trim());
+}
+/** sha256 hex 形状 */
+export function isDigestHex(s) {
+    return /^[0-9a-f]{64}$/.test(String(s || '').trim());
+}
+/** ISO 时间串形状 (可被 Date.parse 解出) */
+function isIso(s) {
+    return typeof s === 'string' && s.length >= 20 && Number.isFinite(Date.parse(s));
+}
+/**
+ * 时效检查 (桌面与手机都跑):
+ *   · createdAt/expiresAt 必须是能解析的 ISO 串
+ *   · expiresAt - createdAt ≤ TTL 上限
+ *   · now 落在 [createdAt - skew, expiresAt] 之内
+ */
+export function checkTaskActionFreshness(a, now) {
+    if (!isIso(a?.createdAt) || !isIso(a?.expiresAt))
+        return { ok: false, reason: 'bad_time' };
+    const created = Date.parse(a.createdAt);
+    const expires = Date.parse(a.expiresAt);
+    if (expires - created > TASK_ACTION_TTL_MS)
+        return { ok: false, reason: 'ttl_too_long' };
+    if (expires < created)
+        return { ok: false, reason: 'bad_time' };
+    if (now > expires)
+        return { ok: false, reason: 'expired' };
+    if (now < created - TASK_ACTION_CLOCK_SKEW_MS)
+        return { ok: false, reason: 'not_yet_valid' };
+    return { ok: true };
+}
+/** 载荷形状检查 (验签前的形状闸: 少了字段就别去碰公钥) */
+export function checkTaskActionShape(input) {
+    const a = input?.action || input;
+    if (!a || typeof a !== 'object')
+        return { ok: false, reason: 'missing_action' };
+    if (!isTaskActionId(a.actionId))
+        return { ok: false, reason: 'bad_action_id' };
+    if (!MOBILE_TASK_ACTION_KINDS.includes(String(a.kind)))
+        return { ok: false, reason: 'unknown_kind' };
+    if (!/^dev-[A-Za-z0-9._-]{4,40}$/.test(String(a.deviceId || '')))
+        return { ok: false, reason: 'bad_device_id' };
+    if (!isDigestHex(a.contentDigest))
+        return { ok: false, reason: 'bad_content_digest' };
+    if (a.via !== 'mobile')
+        return { ok: false, reason: 'bad_via' };
+    if (!isIso(a.createdAt) || !isIso(a.expiresAt))
+        return { ok: false, reason: 'bad_time' };
+    return { ok: true, action: a };
+}
+/** 桌面侧: 请求里必须只有**属于这个 kind** 的业务字段 (防止一次入群签名被塞进发公告的字段) */
+export function actionKindAllowsRequest(kind, req) {
+    const hasGroup = !!(req?.groupRef && String(req.groupRef).trim());
+    const hasAnn = !!(req?.announcementId && String(req.announcementId).trim());
+    switch (kind) {
+        case 'group_join':
+            return hasGroup ? { ok: true } : { ok: false, error: '入群需要群链接 (groupRef)' };
+        case 'group_leave':
+            return hasGroup ? { ok: true } : { ok: false, error: '退群需要群 (groupRef)' };
+        case 'group_create':
+            return { ok: true };
+        case 'announce_publish':
+            return hasGroup ? { ok: false, error: '发布公告不进群 (要发进群请用 announce_to_group) —— 这类动作必须分开签' } : { ok: true };
+        case 'announce_to_group':
+            return hasGroup && hasAnn ? { ok: true } : { ok: false, error: '公告入群需要群 (groupRef) 与公告号 (announcementId)' };
+        case 'trail_post':
+            if (!hasGroup || !hasAnn)
+                return { ok: false, error: '过程留痕要挂在某一条公告上, 且要指定群 (groupRef + announcementId)' };
+            return ['claim', 'deliver', 'screen', 'final'].includes(String(req?.trailKind))
+                ? { ok: true }
+                : { ok: false, error: '过程留痕需要 trailKind (claim|deliver|screen|final)' };
+        default:
+            return { ok: false, error: `未知动作: ${String(kind || '')}` };
+    }
+}

package/dist/agents/mobile-task-views.js

@@ -0,0 +1,199 @@
+/**
+ * mobile-task-views.ts — 手机端「任务」页的**视图投影** (2026-09-25)
+ *
+ * 桌面 API 返回的是完整事实 (给机器看的); 手机页面要的是**能直接渲染、且不含标识符**的行。
+ * 投影集中放在这里 (纯函数), 因为这几条是硬要求, 必须能被单测钉住:
+ *   · **不出现** 原始 DID / peerId / IP / 钱包地址 / 群 store 地址 / 任务正文 —— 每条 id 只给缩短形式
+ *   · 群消息里的事实本来就由桌面侧 `summarizeTrail` 遮蔽过 (这里只再挡一道, 不重复造规则表)
+ *   · 相对时间给**毫秒差**, 由 UI 只改文字节点 (不在投影里拼字符串, 免得时间一成不变)
+ *
+ * 词汇表 (中文) 与 `task-group.ts` 的 `TRAIL_KIND_LABEL` 对齐 —— 有单测钉住"不许漂移"。
+ */
+import { scanPublicText } from './task-public-text.js';
+/** id 缩短显示 (前 n 位 + 省略号); 空 → 空串 (不显示 `undefined`) */
+export function shortId(id, n = 12) {
+    const s = String(id ?? '').trim();
+    if (!s)
+        return '';
+    return s.length <= n ? s : `${s.slice(0, n)}…`;
+}
+/**
+ * 协议 id (公告号 / 动作号 / OrbitDB 地址) —— 这些不是 DID/地址, 规则表不认,
+ * 但**原文一样不许上手机页面**, 一律走 shortened 形式。
+ */
+export function isProtocolId(s) {
+    const v = String(s ?? '').trim();
+    return /^ann-[0-9a-f]{8,}$/i.test(v)
+        || /^act-[a-z0-9-]{6,}$/i.test(v)
+        || /^zdpu[0-9a-zA-Z]{8,}$/.test(v)
+        || /^\/orbitdb\//.test(v);
+}
+/** 「多久以前 / 还有多久」的人话 (毫秒差 → 双语; UI 只把结果写进文字节点) */
+export function formatRelative(ms, lang) {
+    if (ms === null || !Number.isFinite(ms))
+        return lang === 'zh' ? '—' : '—';
+    const past = ms >= 0;
+    const abs = Math.abs(ms);
+    const min = Math.floor(abs / 60_000);
+    const hr = Math.floor(abs / 3_600_000);
+    const day = Math.floor(abs / 86_400_000);
+    const unit = day >= 1
+        ? (lang === 'zh' ? `${day} 天` : `${day} d`)
+        : hr >= 1
+            ? (lang === 'zh' ? `${hr} 小时` : `${hr} h`)
+            : min >= 1
+                ? (lang === 'zh' ? `${min} 分钟` : `${min} min`)
+                : (lang === 'zh' ? '不到 1 分钟' : 'under a minute');
+    if (lang === 'zh')
+        return past ? `${unit}前` : `${unit}后`;
+    return past ? `${unit} ago` : `in ${unit}`;
+}
+// ── 公告板 ──────────────────────────────────────────────────────────────────
+export const STATUS_LABELS = {
+    open: { zh: '可接单', en: 'Open for claims' },
+    claimed: { zh: '已被接单', en: 'Claimed' },
+    cancelled: { zh: '已取消', en: 'Cancelled' },
+    unknown: { zh: '状态未知', en: 'Unknown status' },
+};
+function budgetLabelOf(b) {
+    if (!b || typeof b !== 'object')
+        return '';
+    const amt = String(b.maxAmount ?? '').trim();
+    if (!amt)
+        return '';
+    return `${amt} ${String(b.currency || '').toUpperCase()}${b.network ? ` · ${String(b.network)}` : ''}`;
+}
+/** 板上的一条 → 手机行 (buyerDid / claimedBy 一律丢弃: 那是身份, 不是手机该显示的东西) */
+export function boardItemOf(e, now) {
+    const dl = Number.isFinite(Number(e?.deadline)) ? Number(e.deadline) : null;
+    const ca = Number.isFinite(Number(e?.createdAt)) ? Number(e.createdAt) : null;
+    const status = String(e?.status || 'unknown');
+    return {
+        idShort: shortId(e?.announcementId),
+        ref: String(e?.announcementId || ''),
+        capability: String(e?.capability || ''),
+        status,
+        statusLabel: STATUS_LABELS[status] || STATUS_LABELS.unknown,
+        budgetLabel: budgetLabelOf(e?.budget),
+        deadlineInMs: dl === null ? null : dl - now,
+        createdAtMs: ca,
+        claimCount: Number.isFinite(Number(e?.claimCount)) ? Number(e.claimCount) : 0,
+        preview: e?.instructionPreview ? String(e.instructionPreview).slice(0, 120) : null,
+        remote: !!e?.remote,
+        claimable: !!e?.claimable,
+        signatureVerified: e?.signatureVerified === true ? true : (e?.signatureVerified === false ? false : null),
+    };
+}
+export function buildBoardView(view, now) {
+    const items = (Array.isArray(view?.entries) ? view.entries : []).map((e) => boardItemOf(e, now));
+    return {
+        items,
+        localCount: Number(view?.localCount) || 0,
+        remoteCount: Number(view?.remoteCount) || 0,
+        registryReady: view?.registryReady === true,
+        registryError: view?.registryError ? String(view.registryError).slice(0, 160) : null,
+        notes: Array.isArray(view?.notes) ? view.notes.map((n) => String(n)) : [],
+        openCount: items.filter((i) => i.claimable).length,
+    };
+}
+// ── 过程痕迹 (trail) ────────────────────────────────────────────────────────
+export const TRAIL_KIND_LABELS = {
+    announce: { zh: '公告', en: 'Announce' },
+    claim: { zh: '接单声明', en: 'Claim' },
+    deliver: { zh: '交付', en: 'Delivery' },
+    screen: { zh: '初筛结果', en: 'Screening' },
+    final: { zh: '终审结论', en: 'Final verdict' },
+};
+export const INCONSISTENCY_LABELS = {
+    'final-accept-without-delivery': { zh: '说通过了, 但群里没有交付痕迹', en: 'Accepted, but no delivery trace in the group' },
+    'screen-without-delivery': { zh: '有初筛结果, 但没有交付痕迹', en: 'Screening exists without a delivery trace' },
+    'claim-without-announce': { zh: '有人接单, 但群里没有公告痕迹', en: 'Claim without an announcement trace' },
+    'deliver-without-claim': { zh: '有交付, 但没人接过单', en: 'Delivery without a claim' },
+    'both-accept-and-reject': { zh: '同时出现通过和拒绝', en: 'Both accepted and rejected appear' },
+    'group-message-hit-privacy-rule': { zh: '群里有人发了带标识符的消息 (已遮蔽, 不当事实采用)', en: 'A group message hit a privacy rule (masked, not used as fact)' },
+};
+/**
+ * 时间线 → 手机行 (字段再过一遍规则表: 命中就只报规则名, 不回显内容)
+ *
+ * 2026-09-25: 除了规则表,**协议 id 一律缩短**。原因: `ann-<16hex>` 不是 DID/地址, 规则表不认它,
+ * 但它就是公告号原文 —— 手机页面上不许出现 (要认哪条公告用缩短形式 + 页面自己按行索引回填)。
+ */
+export function buildTrailView(summary) {
+    const entries = (Array.isArray(summary?.entries) ? summary.entries : []).map((e) => {
+        const facts = [];
+        for (const [k, v] of Object.entries(e?.fields || {})) {
+            if (k === 'kind')
+                continue;
+            const raw = String(v ?? '');
+            const hit = scanPublicText(raw);
+            if (hit.length) {
+                facts.push({ k: String(k), v: `[已遮蔽:${hit[0].rule}]` });
+                continue;
+            }
+            facts.push({ k: String(k), v: k === 'id' || isProtocolId(raw) ? shortId(raw) : raw });
+        }
+        const kind = String(e?.kind || '');
+        return {
+            idShort: shortId(e?.announcementId),
+            kind,
+            kindLabel: TRAIL_KIND_LABELS[kind] || { zh: kind, en: kind },
+            sender: String(e?.sender || 'unknown'),
+            atMs: Number.isFinite(Number(e?.at)) ? Number(e.at) : 0,
+            facts,
+        };
+    });
+    const inc = (Array.isArray(summary?.inconsistencies) ? summary.inconsistencies : []).map((c) => ({
+        code: String(c),
+        label: INCONSISTENCY_LABELS[String(c)] || { zh: String(c), en: String(c) },
+    }));
+    return {
+        count: Number(summary?.count) || entries.length,
+        byKind: (summary?.byKind || {}),
+        entries,
+        announcementIdsShort: (Array.isArray(summary?.announcements) ? summary.announcements : []).map((a) => shortId(a)),
+        flags: (summary?.flags || {}),
+        inconsistencies: inc,
+        redactedCount: Array.isArray(summary?.redacted) ? summary.redacted.length : 0,
+        ignoredMessages: Number(summary?.ignoredMessages) || 0,
+        privacyHits: inc.some((x) => x.code === 'group-message-hit-privacy-rule') || (Array.isArray(summary?.redacted) && summary.redacted.length > 0),
+    };
+}
+/** 本机已加入的群 → 手机行 (store 地址/邀请链接都不在这里: 要链接得显式取, 与 CLI 同一纪律) */
+export function buildGroupsView(groups) {
+    return (Array.isArray(groups) ? groups : []).map((g) => ({
+        idShort: shortId(g?.id),
+        name: String(g?.name || ''),
+        joinedAt: String(g?.createdAt || ''),
+    }));
+}
+// ── 动作请求 → 确认页文案 (展示待发内容) ────────────────────────────────────
+/** 把动作请求压成"你将要发出什么"的人话 (确认页用; 文案里不含标识符) */
+export function describeTaskActionForConfirm(kind, req) {
+    const lines = [];
+    const push = (k, kEn, v) => { const s = String(v ?? '').trim(); if (s && s !== '-')
+        lines.push({ k, kEn, v: s }); };
+    push('群', 'group', req?.groupRef ? shortId(req.groupRef, 24) : '');
+    push('公告号', 'announcement', req?.announcementId ? shortId(req.announcementId) : '');
+    push('能力', 'capability', req?.capability);
+    push('预算', 'budget', req?.budgetHuman ? `${req.budgetHuman} ${String(req?.currency || '').toUpperCase()}` : '');
+    push('任务正文', 'instruction', req?.instruction);
+    push('截止', 'deadline', req?.deadline);
+    push('验收判据', 'criteria', req?.criteria);
+    push('期号', 'round', req?.round);
+    push('痕迹类型', 'trail kind', req?.trailKind ? (TRAIL_KIND_LABELS[String(req.trailKind)]?.zh || String(req.trailKind)) : '');
+    push('声明价格', 'declared price', req?.price);
+    push('交付哈希', 'delivery hash', req?.hash);
+    push('字节数', 'bytes', req?.bytes);
+    push('逐条初筛', 'per-item screen', req?.checks);
+    push('终审结论', 'final verdict', req?.verdict);
+    const titles = {
+        group_join: { zh: '加入这个群', en: 'Join this group' },
+        group_leave: { zh: '退出这个群', en: 'Leave this group' },
+        group_create: { zh: '建一个新群', en: 'Create a new group' },
+        announce_publish: { zh: '发布任务公告', en: 'Publish a task announcement' },
+        announce_to_group: { zh: '把这期公告发进群', en: 'Post this announcement into the group' },
+        trail_post: { zh: '往群里留一条过程痕迹', en: 'Post a process trail entry into the group' },
+    };
+    const t = titles[String(kind)] || { zh: '执行这个动作', en: 'Run this action' };
+    return { titleZh: t.zh, titleEn: t.en, lines };
+}