@geoly-ai/social-hub-cli 0.3.40 → 0.3.42

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to `@geoly-ai/social-hub-cli` are documented in this file.
 
 Release workflow: `pnpm release:cli` → `pnpm publish:cli`.
 
+## [0.3.42] - 2026-09-10
+
+### Added
+
+- watchlist 筛选补齐 CLI/skills 层 + 清两处 sticky 死代码
+
+## [0.3.41] - 2026-09-09
+
+### Added
+
+- 板块新帖监听 P2 —— 近义词扩展 + 帖子类型标注
+- 板块新帖监听 P1 —— 版本化关键词规则 + 命中账本 + 覆盖诊断
+- calendar list-full 补 --offset —— 服务端一直支持,只有下游没暴露
+- 帖子表现新增「序列号范围」筛选
+
+### Changed
+
+- 给偶发失败的用例加取证钩子 —— 默认不激活,只有设 CLI_FLAKE_LOG 才写盘
+
 ## [0.3.40] - 2026-09-04
 
 ### Fixed

package/dist/cmd-manifest.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-09-04T03:00:49.281Z",
-  "cliVersion": "0.3.40",
+  "generatedAt": "2026-09-10T02:54:19.672Z",
+  "cliVersion": "0.3.42",
   "commands": [
     "accounts",
     "accounts brand-bindings",
@@ -249,6 +249,28 @@
     "intelligence kol-intents-create",
     "intelligence kol-profiles-get",
     "intelligence kol-profiles-list",
+    "intelligence monitor-brand-keyword-candidates",
+    "intelligence monitor-expansion-approve",
+    "intelligence monitor-expansion-create",
+    "intelligence monitor-expansion-delete",
+    "intelligence monitor-expansion-generate",
+    "intelligence monitor-expansion-get",
+    "intelligence monitor-expansion-retire",
+    "intelligence monitor-expansions-list",
+    "intelligence monitor-label-spec-activate",
+    "intelligence monitor-label-spec-create",
+    "intelligence monitor-label-spec-delete",
+    "intelligence monitor-label-spec-retire",
+    "intelligence monitor-label-specs-list",
+    "intelligence monitor-ruleset-activate",
+    "intelligence monitor-ruleset-apply-expansions",
+    "intelligence monitor-ruleset-create",
+    "intelligence monitor-ruleset-delete",
+    "intelligence monitor-ruleset-dry-run",
+    "intelligence monitor-ruleset-get",
+    "intelligence monitor-ruleset-retire",
+    "intelligence monitor-ruleset-rules-set",
+    "intelligence monitor-rulesets-list",
     "intelligence monitor-runs-list",
     "intelligence monitors-disable",
     "intelligence monitors-enable",

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AA8mF9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AAg+BD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC;AAQF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE;IACN,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAkJnE;AAyqBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,GAAG,MAAM,CAiBT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAyCpD;AAwyDD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAunF9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AAg+BD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC;AAQF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE;IACN,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAkJnE;AA0qCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,GAAG,MAAM,CAiBT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAyCpD;AAqzDD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -370,6 +370,8 @@ reddit
     .option("--repost-type <t>", "repostType filter (none|first|second)")
     .option("--contains-brand-keyword <v>", "true | false | unset")
     .option("--primary-product <text>", "primary product contains match")
+    .option("--seq-no-min <n>", "序列号下界(含);与 --seq-no-max 组成闭区间,无编号(null)的帖会落选")
+    .option("--seq-no-max <n>", "序列号上界(含)")
     .option("--sort-by <f>", "score|comments_count|posted_at|view_count|seq_no")
     .option("--sort-dir <d>", "asc|desc")
     .option("-n, --limit <n>", "limit per page", "100")
@@ -389,6 +391,8 @@ reddit
         repostType: opts.repostType,
         containsBrandKeyword: opts.containsBrandKeyword,
         primaryProduct: opts.primaryProduct,
+        seqNoMin: opts.seqNoMin !== undefined ? Number(opts.seqNoMin) : undefined,
+        seqNoMax: opts.seqNoMax !== undefined ? Number(opts.seqNoMax) : undefined,
         sortBy: opts.sortBy,
         sortDir: opts.sortDir,
         ...redditAggregateQueryParams(opts),
@@ -2981,12 +2985,41 @@ intel
     .description("GET .../subreddit-intelligence/watchlists")
     .option("--campaign <uuid>", "campaignId")
     .option("--subreddit <name>", "按板块名精确查归属(r/ 可省)")
+    .option("--subreddit-query <text>", "板块名**子串**搜索(大小写不敏感,r/ 可省);与 --subreddit 是两个独立谓词,后者是精确匹配")
+    .option("--status <st>", "active|paused|archived")
+    .option("--brand <uuid>", "brandId:只返回**显式绑定**该品牌的监控池(不含全局池)")
+    .option("--industry-keys <list>", "industryKey 过滤(逗号分隔可多个)")
+    .option("--tag <tag>", "标签精确包含(tags 是 jsonb 数组)")
+    .option("--monitor-state <state>", "新帖监听状态,三值:enabled=在监听 | disabled=加过但已停(软停,配置行还在) | never=从没加过。" +
+    "⚠️ 受限主体(client)传这个会 403")
+    .option("--sort-by <f>", "createdAt|subreddit|monitorLastObservedAt")
+    .option("--sort-dir <d>", "asc|desc")
     .option("-n, --limit <n>", "limit", "100")
     .option("--offset <n>", "offset", "0")
     .action(async (opts) => {
+    // 🔴 显式校验只给 --monitor-state 一个,不是漏了别的:本仓 CLI 的既有惯例是
+    // 枚举透传、由服务端 zod 400(见 hot-posts / voc 的 --sort-by),只有**会被静默
+    // 强转**的选项才本地拦(monitors-list 的 `--enabled` 是 Boolean() 强转)。
+    // monitorState 拦下来的理由不是强转,而是**语义**:它最容易被当成布尔用
+    // (`--monitor-state true` / `false`),而服务端那句 "invalid enum value"
+    // 讲不清 disabled(停了的) 与 never(从没加过) 的区别 —— 而用户提这个需求
+    // 要的正是这个区别。
+    if (opts.monitorState !== undefined &&
+        !["enabled", "disabled", "never"].includes(opts.monitorState))
+        throw new Error("--monitor-state 必须是 enabled | disabled | never 之一(三值,不是布尔):" +
+            "disabled = 加过监听后停了(软停,配置行与观察水位都还在,重新启用不会重复报旧帖);" +
+            "never = 压根没加过监听(需要新建配置行)。想要「没在监听的全部」请分两次查。");
     const res = await requireClient().listSubredditWatchlists({
         campaignId: opts.campaign,
         subreddit: opts.subreddit,
+        subredditQuery: opts.subredditQuery,
+        status: opts.status,
+        brandId: opts.brand,
+        industryKeys: opts.industryKeys,
+        tag: opts.tag,
+        monitorState: opts.monitorState,
+        sortBy: opts.sortBy,
+        sortDir: opts.sortDir,
         limit: Number(opts.limit),
         offset: Number(opts.offset),
     });
@@ -3095,6 +3128,322 @@ intel
     });
     console.log(JSON.stringify(res, null, 2));
 });
+/* ── 监听关键词规则集(0168)。P1「确定性监听骨架」 ──────────────────────────
+ *
+ * 🔴 版本语义:draft 可反复改 → activate 之后**不可原地修改,只能新建版本**。
+ * 🔴 激活/停用**不会重发历史命中** —— 观察的水位在被评估的那一轮就推进了(无论命中与否)。
+ *    这是刻意的:否则调一次关键词,负责人就被历史帖子刷一次屏。追溯需显式 replay(P3)。
+ * ⚠️ 停用当前版本 = 回到「不设关键词门」,报告**恢复全量新帖**,不是一条都不报。
+ * ⚠️ 本期只有 include(排除词是 P2,契约层就表达不出来)。
+ * ────────────────────────────────────────────────────────────────────────── */
+intel
+    .command("monitor-rulesets-list")
+    .description("GET .../monitors/:monitorId/rule-sets —— 某监听的全部规则版本(version DESC)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID(不是 watchlist id)")
+    .option("--status <status>", "draft|active|retired")
+    .option("-n, --limit <n>", "limit", "20")
+    .action(async (opts) => {
+    const res = await requireClient().listSubredditMonitorRuleSets(opts.monitor, {
+        status: opts.status,
+        limit: Number(opts.limit),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-get")
+    .description("GET .../monitors/:monitorId/rule-sets/:ruleSetId —— 含全部规则")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID")
+    .action(async (opts) => {
+    const res = await requireClient().getSubredditMonitorRuleSet(opts.monitor, opts.ruleSet);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-create")
+    .description("POST .../monitors/:monitorId/rule-sets —— 新建 **draft** 版本(不会自动激活)。" +
+    "规则形状:[{term,scope?,matchMode?,weight?}];scope=title|body|both,matchMode=word|substring|phrase")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .option("--lookback <minutes>", "回看窗口,只允许 720(12h)或 1440(24h);run 窗口取所有启用监听里最长的一档")
+    .option("--note <text>", "本版说明(会随版本链留痕,作为审计的一部分)")
+    .option("-j, --json <json>", "规则数组 JSON;省略则建空 draft 再用 rules-set 填")
+    .action(async (opts) => {
+    const res = await requireClient().createSubredditMonitorRuleSet(opts.monitor, {
+        ...(opts.lookback === undefined
+            ? {}
+            : { lookbackMinutes: Number(opts.lookback) }),
+        ...(opts.note === undefined ? {} : { note: opts.note }),
+        ...(opts.json === undefined ? {} : { rules: JSON.parse(opts.json) }),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-rules-set")
+    .description("PUT .../rule-sets/:ruleSetId/rules —— **整批替换** draft 的规则(传什么就是最终全量)。" +
+    "已激活的版本会被服务端 409 拒绝:改规则必须新建版本")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID(必须是 draft)")
+    .requiredOption("-j, --json <json>", "规则数组 JSON(全量)")
+    .option("--lookback <minutes>", "顺带改回看窗口(720|1440)")
+    .action(async (opts) => {
+    const res = await requireClient().replaceSubredditMonitorRules(opts.monitor, opts.ruleSet, {
+        rules: JSON.parse(opts.json),
+        ...(opts.lookback === undefined
+            ? {}
+            : { lookbackMinutes: Number(opts.lookback) }),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-activate")
+    .description("POST .../rule-sets/:ruleSetId/activate —— 激活该版本,当前 active 自动 retire。" +
+    "🔴 不会重发历史命中;空规则集会被拒(那等于把整个板块静音)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID(必须是 draft)")
+    .action(async (opts) => {
+    const res = await requireClient().activateSubredditMonitorRuleSet(opts.monitor, opts.ruleSet);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-retire")
+    .description("POST .../rule-sets/:ruleSetId/retire —— 停用。" +
+    "⚠️ 停用后该监听回到「不设关键词门」,报告**恢复全量新帖**,不是一条都不报")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID")
+    .action(async (opts) => {
+    const res = await requireClient().retireSubredditMonitorRuleSet(opts.monitor, opts.ruleSet);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-delete")
+    .description("DELETE .../rule-sets/:ruleSetId —— 只能删 draft。已激活/已停用的版本必须留痕(服务端 409)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID(必须是 draft)")
+    .action(async (opts) => {
+    const res = await requireClient().deleteSubredditMonitorRuleSetDraft(opts.monitor, opts.ruleSet);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-dry-run")
+    .description("POST .../rule-sets/:ruleSetId/dry-run —— 🔴 **试跑**:拿过去 12h/24h 的历史帖子跑一遍," +
+    "看会命中什么。**只读:不写命中账本、不推进水位、不发任何通知**。" +
+    "先看 sampled:它是 0 时「0 命中」说明的是没有样本,不是规则太窄。" +
+    "termHitCounts 看哪个词过宽,unusedTerms 看哪个词拼错了")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID(draft 或 active 都可以)")
+    .option("--lookback <minutes>", "720|1440;缺省用规则集自己的 lookback")
+    .option("-n, --limit <n>", "取样上限", "200")
+    .option("--matched-only", "只回命中的。⚠️ 默认给全量是刻意的 —— 要判断词是不是配窄了,必须看到没命中的长什么样")
+    .action(async (opts) => {
+    const res = await requireClient().dryRunSubredditMonitorRules(opts.monitor, opts.ruleSet, {
+        ...(opts.lookback === undefined
+            ? {}
+            : { lookbackMinutes: Number(opts.lookback) }),
+        limit: Number(opts.limit),
+        ...(opts.matchedOnly ? { matchedOnly: true } : {}),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-brand-keyword-candidates")
+    .description("GET .../monitors/:monitorId/brand-keyword-candidates —— 从品牌词取导入候选(只读)。" +
+    "⚠️ 语义是**快照复制**不是订阅:导入后品牌词再变,已激活的规则集不会跟着变 —— " +
+    "否则给某品牌加一个词、或把品牌绑到这个 watchlist,都会让监听范围悄然扩大")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .option("--brands <ids>", "逗号分隔的品牌 id;缺省取该 watchlist 已绑定的全部品牌")
+    .option("-n, --limit <n>", "limit", "200")
+    .action(async (opts) => {
+    const res = await requireClient().listSubredditMonitorBrandKeywordCandidates(opts.monitor, {
+        ...(opts.brands ? { brandIds: String(opts.brands).split(",") } : {}),
+        limit: Number(opts.limit),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+/* ── 近义词扩展集（0169）· 板块新帖监听 P2 ──────────────────────────────────
+ *
+ * 🔴 链路是 **离线生成 → 审核 → 固化 → 物化进 draft → 激活**，四步缺一不可：
+ *   1. expansion-generate（或 expansion-create 手工录词）→ 产出 **proposed**
+ *   2. expansion-approve                                   → 内容**就此冻结**
+ *   3. ruleset-apply-expansions                            → **复制**进某个 draft
+ *   4. monitor-ruleset-activate                            → 才真正生效
+ *
+ * ⛔ **生产匹配路径上没有任何即时展开**。理由:同一原词在不同时间可能得到不同词集
+ * (模型会漂、prompt 会改),即时展开会让「昨天没命中、今天命中了」**无法解释** ——
+ * 而这个监听的全部价值就建立在「能说清为什么命中」上。
+ *
+ * ⚠️ 否决(proposed→retired)与下架(approved→retired)是**两件事**:
+ * 被否决过的词**永远**进不了 active 规则集(DB 激活闸拦);而下架只是不再供新的物化使用,
+ * 已经复制进规则集的词不受影响 —— 它们拿的是拷贝。
+ * ────────────────────────────────────────────────────────────────────────── */
+intel
+    .command("monitor-expansions-list")
+    .description("GET .../monitors/:monitorId/expansion-sets —— 某监听的近义词扩展集(created_at DESC)。" +
+    "--status proposed 就是「还有哪些等我审」")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .option("--status <status>", "proposed|approved|retired")
+    .option("-n, --limit <n>", "limit", "20")
+    .action(async (opts) => {
+    const res = await requireClient().listSubredditMonitorExpansionSets(opts.monitor, {
+        status: opts.status,
+        limit: Number(opts.limit),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-expansion-get")
+    .description("GET .../expansion-sets/:expansionSetId —— 含固化的完整词集")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--expansion-set <uuid>", "Expansion set UUID")
+    .action(async (opts) => {
+    const res = await requireClient().getSubredditMonitorExpansionSet(opts.monitor, opts.expansionSet);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-expansion-generate")
+    .description("POST .../expansion-sets/generate —— 🔴 **离线**用 LLM 生成近义词候选。" +
+    "产出恒为 **proposed**,进不了任何 active 规则集,必须再 approve + apply。" +
+    "provider 没配 ⇒ 409(功能未启用,可改用 monitor-expansion-create 手工录词)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--term <text>", "原词(必须是规则集里已有/将有的那个词)")
+    .option("--language <tag>", "语言标记;und=未指定。同一原词不同语言各批一套", "und")
+    .action(async (opts) => {
+    const res = await requireClient().generateSubredditMonitorExpansion(opts.monitor, { baseTerm: opts.term, language: opts.language });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-expansion-create")
+    .description("POST .../expansion-sets —— 人工录入候选词表(provider 没配时的路径)。产出恒为 proposed")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--term <text>", "原词")
+    .requiredOption("-j, --json <json>", '候选词数组 JSON,如 ["latte","espresso shot"]')
+    .option("--language <tag>", "语言标记", "und")
+    .action(async (opts) => {
+    const res = await requireClient().createSubredditMonitorExpansionSet(opts.monitor, {
+        baseTerm: opts.term,
+        language: opts.language,
+        terms: JSON.parse(opts.json),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-expansion-approve")
+    .description("POST .../expansion-sets/:id/approve —— 批准。" +
+    "🔴 批准之后**内容就冻住了**(DB 焊死,只能另提一份新候选)。" +
+    "批准 ≠ 生效:还要 ruleset-apply-expansions 物化 + activate")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--expansion-set <uuid>", "Expansion set UUID(必须是 proposed)")
+    .option("--note <text>", "审核意见(写进版本链,是审计的一部分)")
+    .action(async (opts) => {
+    const res = await requireClient().approveSubredditMonitorExpansionSet(opts.monitor, opts.expansionSet, { ...(opts.note === undefined ? {} : { reviewNote: opts.note }) });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-expansion-retire")
+    .description("POST .../expansion-sets/:id/retire —— 否决(从 proposed)或下架(从 approved)。" +
+    "⚠️ **被否决的永远进不了 active 规则集**;而下架只是不再供新的物化使用," +
+    "已经复制进规则集的词不受影响(它们拿的是拷贝)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--expansion-set <uuid>", "Expansion set UUID")
+    .option("--note <text>", "审核意见")
+    .action(async (opts) => {
+    const res = await requireClient().retireSubredditMonitorExpansionSet(opts.monitor, opts.expansionSet, { ...(opts.note === undefined ? {} : { reviewNote: opts.note }) });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-expansion-delete")
+    .description("DELETE .../expansion-sets/:id —— 只能删 proposed。审核过的必须留痕(改用 retire)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--expansion-set <uuid>", "Expansion set UUID")
+    .action(async (opts) => {
+    const res = await requireClient().deleteSubredditMonitorExpansionSet(opts.monitor, opts.expansionSet);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-ruleset-apply-expansions")
+    .description("POST .../rule-sets/:ruleSetId/apply-expansions —— 🔴 **物化**:把 approved 的近义词" +
+    "**复制**成 draft 规则集里的真实规则行(与品牌词导入同一手法)。" +
+    "⚠️ 物化 ≠ 生效,之后还要 monitor-ruleset-activate。" +
+    "⚠️ 点名的扩展集里有未批准的 ⇒ 409(⛔ 不静默少物化几条 —— 那会让你以为词已经生效了)")
+    .requiredOption("--monitor <uuid>", "Monitor UUID")
+    .requiredOption("--rule-set <uuid>", "Rule set UUID(必须是 draft)")
+    .option("-j, --json <json>", "限定扩展集 id 数组 JSON;省略 = 该监听全部 approved 的")
+    .action(async (opts) => {
+    const res = await requireClient().applyExpansionsToRuleSet(opts.monitor, opts.ruleSet, {
+        ...(opts.json === undefined
+            ? {}
+            : { expansionSetIds: JSON.parse(opts.json) }),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+/* ── 标签 spec / taxonomy（0169）· 系统级 ─────────────────────────────────
+ * ⛔ 刻意**不走**四眼审批(需求明说太重、会拖慢提醒),但发布本身是不可变版本链。
+ * ⚠️ taxonomyVersion **全局唯一**:换 prompt/换模型/加 key 都要起新值,
+ * 否则标签行会互相覆盖,「这个标签是哪版规则打的」失去答案。
+ * ⚠️ 停用当前 spec = **标签功能整体关闭**(卡片不再显示标签行)。
+ * ─────────────────────────────────────────────────────────────────────── */
+intel
+    .command("monitor-label-specs-list")
+    .description("GET .../label-specs —— 标签 spec 版本链(version DESC)")
+    .option("--status <status>", "draft|active|retired")
+    .option("-n, --limit <n>", "limit", "20")
+    .action(async (opts) => {
+    const res = await requireClient().listSubredditMonitorLabelSpecs({
+        status: opts.status,
+        limit: Number(opts.limit),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-label-spec-create")
+    .description("POST .../label-specs —— 新建 **draft** spec(不会自动激活)。" +
+    "--keys 是稳定 key 白名单,模型只能从里面选,自创的一律丢弃")
+    .requiredOption("--taxonomy <version>", "🔴 全局唯一。换 prompt/换模型/加 key 都要起新值")
+    .requiredOption("--keys <keys>", "逗号分隔,如 recommendation_request,comparison,review")
+    .requiredOption("--prompt-version <v>", "prompt 版本(审计的一部分)")
+    .option("--model <name>", "指定模型;省略则用 env 里那一档")
+    .option("--temperature <n>", "温度")
+    .option("--note <text>", "本版说明")
+    .action(async (opts) => {
+    const res = await requireClient().createSubredditMonitorLabelSpec({
+        taxonomyVersion: opts.taxonomy,
+        labelKeys: String(opts.keys)
+            .split(",")
+            .map((k) => k.trim())
+            .filter(Boolean),
+        promptVersion: opts.promptVersion,
+        ...(opts.model === undefined ? {} : { model: opts.model }),
+        ...(opts.temperature === undefined
+            ? {}
+            : { temperature: Number(opts.temperature) }),
+        ...(opts.note === undefined ? {} : { note: opts.note }),
+    });
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-label-spec-activate")
+    .description("POST .../label-specs/:specId/activate —— 激活(当前 active 自动 retire)。" +
+    "激活后 active 版本**不可原地改**,只能新建版本")
+    .requiredOption("--spec <uuid>", "Label spec UUID(必须是 draft)")
+    .action(async (opts) => {
+    const res = await requireClient().activateSubredditMonitorLabelSpec(opts.spec);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-label-spec-retire")
+    .description("POST .../label-specs/:specId/retire —— ⚠️ 停用 = **标签功能整体关闭**" +
+    "(卡片不再显示标签行);新帖提醒本身不受影响")
+    .requiredOption("--spec <uuid>", "Label spec UUID(必须是 active)")
+    .action(async (opts) => {
+    const res = await requireClient().retireSubredditMonitorLabelSpec(opts.spec);
+    console.log(JSON.stringify(res, null, 2));
+});
+intel
+    .command("monitor-label-spec-delete")
+    .description("DELETE .../label-specs/:specId —— 只能删 draft")
+    .requiredOption("--spec <uuid>", "Label spec UUID")
+    .action(async (opts) => {
+    const res = await requireClient().deleteSubredditMonitorLabelSpecDraft(opts.spec);
+    console.log(JSON.stringify(res, null, 2));
+});
 intel
     .command("hot-posts")
     .description("GET .../subreddit-intelligence/hot-posts")
@@ -4064,7 +4413,10 @@ calendar
     .option("--status <st>", "scheduled|running|succeeded|…")
     .option("--from <iso>", "from ISO 时间")
     .option("--to <iso>", "to ISO 时间")
-    .option("-n, --limit <n>", "limit", "50")
+    .option("-n, --limit <n>", "limit(服务端上限 200)", "50")
+    // 🔴 服务端一直支持 offset,此前只有 CLI 没暴露 —— 调用方要么撞上限,
+    // 要么自己拿时间窗二分绕(矩阵侧实测:那样会静默漏掉更早的条目且不报错)。
+    .option("--offset <n>", "offset(翻页;默认 0)")
     .action(async (opts) => {
     const res = await requireClient().listCalendarEntries(resolveTeamId(opts.team), {
         campaignId: opts.campaign,
@@ -4074,6 +4426,7 @@ calendar
         from: opts.from,
         to: opts.to,
         limit: Number(opts.limit),
+        ...(opts.offset === undefined ? {} : { offset: Number(opts.offset) }),
     });
     console.log(JSON.stringify(res, null, 2));
 });
@@ -4109,6 +4462,8 @@ reddit
     .option("--repost-type <t>", "repostType filter (none|first|second)")
     .option("--contains-brand-keyword <v>", "true | false | unset")
     .option("--primary-product <text>", "primary product contains match")
+    .option("--seq-no-min <n>", "序列号下界(含);与 --seq-no-max 组成闭区间,无编号(null)的帖会落选")
+    .option("--seq-no-max <n>", "序列号上界(含)")
     .option("--sort-by <f>", "score|comments_count|posted_at|view_count|seq_no")
     .option("--sort-dir <d>", "asc|desc")
     .option("-n, --limit <n>", "limit per page", "100")
@@ -4127,6 +4482,8 @@ reddit
         repostType: opts.repostType,
         containsBrandKeyword: opts.containsBrandKeyword,
         primaryProduct: opts.primaryProduct,
+        seqNoMin: opts.seqNoMin !== undefined ? Number(opts.seqNoMin) : undefined,
+        seqNoMax: opts.seqNoMax !== undefined ? Number(opts.seqNoMax) : undefined,
         sortBy: opts.sortBy,
         sortDir: opts.sortDir,
         limit: Number(opts.limit),