@geoly-ai/social-hub-cli 0.2.19 → 0.2.21

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to `@geoly-ai/social-hub-cli` are documented in this file.
 
 Release workflow: `pnpm release:cli` → `pnpm publish:cli`.
 
+## [0.2.21] - 2026-07-22
+
+### Added
+
+- 支持受限主体 + 维度派发前鉴权(板块情报收尾 B)
+- 评论回灌直接带分析标签 + 正文编辑标签失效(板块情报收尾 A)
+
+## [0.2.20] - 2026-07-22
+
+### Added
+
+- VOC 有界编排 CLI 命令(板块情报 #6)
+
 ## [0.2.19] - 2026-07-22
 
 ### Added

package/dist/cmd-manifest.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-07-22T10:31:07.316Z",
-  "cliVersion": "0.2.19",
+  "generatedAt": "2026-07-22T12:34:00.265Z",
+  "cliVersion": "0.2.21",
   "commands": [
     "accounts",
     "accounts brand-bindings",
@@ -197,6 +197,7 @@
     "intelligence tier-rules-delete",
     "intelligence tier-rules-list",
     "intelligence tier-rules-update",
+    "intelligence voc-acquire",
     "intelligence voc-query",
     "intelligence voc-summary",
     "intelligence watchlists-create",

package/dist/index.d.ts

@@ -3,5 +3,24 @@ import { Command } from "commander";
 declare const program: Command;
 /** 返回放错位置字段的指引(无则 null)。用于 accounts update / sync core 防呆。 */
 export declare function detectMisplacedAccountFields(body: Record<string, unknown>): string | null;
+export type VocAcquireClient = {
+    vocQuery(body: unknown): Promise<Record<string, unknown>>;
+    getIntelRunProgress(runId: string): Promise<{
+        status: string;
+    }>;
+};
+export declare function orchestrateVocAcquire(client: VocAcquireClient, params: {
+    query: Record<string, unknown>;
+    requirements: Record<string, unknown>;
+    maxRounds: number;
+    timeoutMs: number;
+    pollMs: number;
+    async: boolean;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<{
+    exitCode: 0 | 1 | 2;
+    output: Record<string, unknown>;
+}>;
 export { program };
 //# sourceMappingURL=index.d.ts.map

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;AA2BpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAiqD9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AAujGD,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;AA2BpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAiqD9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AAs+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;AA0pED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -2040,6 +2040,221 @@ intel
     });
     console.log(JSON.stringify(res, null, 2));
 });
+const VOC_TERMINAL = new Set(["succeeded", "failed", "partial"]);
+function httpStatusOf(e) {
+    const m = /^HTTP (\d+)/.exec(String(e?.message));
+    return m ? Number(m[1]) : null;
+}
+class VocDeadlineError extends Error {
+}
+export async function orchestrateVocAcquire(client, params) {
+    const now = params.now ?? (() => Date.now());
+    const sleep = params.sleep ??
+        ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const deadline = now() + params.timeoutMs;
+    const remaining = () => deadline - now();
+    // 每个请求受"剩余总时限"约束——收 thunk 而非已创建的 promise:先查 remaining 再发起,
+    // 否则超时后仍会启动下一轮派发副作用(rem<=0 时根本不调 fn)。
+    const withDeadline = async (fn) => {
+        const rem = remaining();
+        if (rem <= 0)
+            throw new VocDeadlineError();
+        let timer;
+        const timeout = new Promise((_, rej) => {
+            timer = setTimeout(() => rej(new VocDeadlineError()), rem);
+        });
+        try {
+            // 注:Promise.race 只限制 CLI 等待时间,不取消已发出的 fetch(真正取消需 SDK AbortSignal)。
+            return await Promise.race([fn(), timeout]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+    const satisfied = (r) => Boolean(r.coverage?.overall
+        ?.satisfied);
+    const timeoutOut = (round, pending, coverage) => ({
+        exitCode: 2,
+        output: {
+            status: "timeout",
+            rounds: round,
+            pendingRunIds: pending,
+            coverage,
+        },
+    });
+    try {
+        // 无角色预检:权限由服务端强制。voc-query(第一次调用)若无 evidence create 会在**任何派发副作用前**
+        // 403 → 抛出 → 命令层退 1;有权则派发 + 轮询(受限主体持 runId + dimension read 可轮询 /runs/:runId)。
+        let round = 0;
+        let last = {};
+        while (round < params.maxRounds) {
+            round += 1;
+            last = await withDeadline(() => client.vocQuery({
+                query: params.query,
+                requirements: params.requirements,
+                policy: { dispatchOnGap: true },
+            }));
+            if (satisfied(last)) {
+                return {
+                    exitCode: 0,
+                    output: {
+                        status: "satisfied",
+                        rounds: round,
+                        coverage: last.coverage,
+                    },
+                };
+            }
+            const dispatched = (last.dispatched ?? []);
+            const runIds = [...new Set(dispatched.map((d) => d.runId))];
+            if (params.async) {
+                return {
+                    exitCode: 2,
+                    output: {
+                        status: "dispatched",
+                        waited: false,
+                        dispatched,
+                        coverage: last.coverage,
+                    },
+                };
+            }
+            if (runIds.length === 0)
+                break; // 缺口但无可派发(如 evidence 额度耗尽)→ 需外部 import。
+            const pending = new Set(runIds);
+            while (pending.size) {
+                if (remaining() <= 0)
+                    return timeoutOut(round, [...pending], last.coverage);
+                for (const rid of [...pending]) {
+                    try {
+                        const p = await withDeadline(() => client.getIntelRunProgress(rid));
+                        if (VOC_TERMINAL.has(p.status))
+                            pending.delete(rid);
+                    }
+                    catch (e) {
+                        if (e instanceof VocDeadlineError)
+                            return timeoutOut(round, [...pending], last.coverage);
+                        const st = httpStatusOf(e);
+                        // 401/403=能派不能读进度;404=run 竟不存在——都是明确错误,立即退 1(不误当完成)。
+                        if (st === 401 || st === 403)
+                            return {
+                                exitCode: 1,
+                                output: {
+                                    status: "forbidden",
+                                    reason: "run 进度无读权限(可能能派不能读)",
+                                    runId: rid,
+                                },
+                            };
+                        if (st === 404)
+                            return {
+                                exitCode: 1,
+                                output: { status: "run_not_found", runId: rid },
+                            };
+                        // 5xx / 网络抖动:保留 pending,deadline 内重试(不误删为完成)。
+                    }
+                }
+                if (pending.size)
+                    await sleep(Math.min(params.pollMs, remaining()));
+            }
+        }
+        // 多轮后重算 coverage 作最终验收(纯读,不再派发)。
+        const finalRes = await withDeadline(() => client.vocQuery({
+            query: params.query,
+            requirements: params.requirements,
+            policy: { dispatchOnGap: false },
+        }));
+        if (satisfied(finalRes)) {
+            return {
+                exitCode: 0,
+                output: {
+                    status: "satisfied",
+                    rounds: round,
+                    coverage: finalRes.coverage,
+                },
+            };
+        }
+        return {
+            exitCode: 2,
+            output: {
+                status: "unsatisfied",
+                rounds: round,
+                coverage: finalRes.coverage,
+                // 不武断断言"必须"外部 import(worker 失败/权限/内部 enqueue 失败也会到这)。
+                externalImportMayBeRequired: true,
+                reason: "多轮采集后 coverage 仍不满足(常见:evidence 额度耗尽 / 无命中帖;也可能是采集失败)",
+                recommendedCommand: "本地 VOC 自爬后回灌:social-hub intelligence evidence-import --file <evidence.json>(和/或 posts-import/comments-import)",
+            },
+        };
+    }
+    catch (e) {
+        if (e instanceof VocDeadlineError)
+            return { exitCode: 2, output: { status: "timeout", reason: "总超时" } };
+        throw e; // 网络/鉴权等真实错误 → 交给命令层退 1。
+    }
+}
+intel
+    .command("voc-acquire")
+    .description("VOC 有界编排(Hub-native):循环 voc-query --dispatch-on-gap → 轮询 run 到终态 → 重算 coverage 验收 → " +
+    "缺口再派一轮。退出码 0=coverage 满足 / 2=尚未满足(超时/多轮后仍缺口,可能需外部 import)/ 1=错误。" +
+    "评估口径同 voc-query;受限主体亦可(权限由服务端强制:需 evidence create + 该 dimension read);--async 只派发不等待。")
+    .option("--brand-keywords <list>", "品牌词,逗号分隔")
+    .option("--competitor-keywords <list>", "竞品词,逗号分隔")
+    .option("--subreddits <list>", "板块,逗号分隔")
+    .option("--time-window <w>", "day|week|month", "week")
+    .option("--min-posts <n>", "最小帖子数", "30")
+    .option("--min-subreddits <n>", "最小板块数", "3")
+    .option("--need-comments", "要求评论覆盖")
+    .option("--min-comments <n>", "最小评论数")
+    .option("--need-rules-evidence", "要求版规证据")
+    .option("--freshness-hours <n>", "数据最大年龄(小时)")
+    .option("--max-rounds <n>", "最多派发轮数", "3")
+    .option("--timeout <s>", "总超时(秒)", "300")
+    .option("--poll-interval <s>", "run 轮询间隔(秒)", "5")
+    .option("--async", "只派发第一轮缺口、不等待(打印 runIds 后退 2)")
+    .action(async (opts) => {
+    const csv = (v) => v
+        ? String(v)
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : undefined;
+    // 显式校验正整数(负/0/小数应报错,不静默回退)。
+    const posInt = (raw, name, dflt) => {
+        if (raw === undefined)
+            return dflt;
+        const n = Number(raw);
+        if (!Number.isInteger(n) || n <= 0) {
+            console.error(`${name} 须为正整数,得到 ${raw}`);
+            process.exit(1);
+        }
+        return n;
+    };
+    const client = requireClient();
+    const query = {
+        brandKeywords: csv(opts.brandKeywords),
+        competitorKeywords: csv(opts.competitorKeywords),
+        subreddits: csv(opts.subreddits),
+        timeWindow: opts.timeWindow,
+    };
+    const requirements = {
+        minPosts: Number(opts.minPosts),
+        minSubreddits: Number(opts.minSubreddits),
+        needComments: Boolean(opts.needComments),
+        ...(opts.minComments ? { minComments: Number(opts.minComments) } : {}),
+        needRulesEvidence: Boolean(opts.needRulesEvidence),
+        ...(opts.freshnessHours
+            ? { freshnessHours: Number(opts.freshnessHours) }
+            : {}),
+    };
+    const { exitCode, output } = await orchestrateVocAcquire(client, {
+        query,
+        requirements,
+        maxRounds: posInt(opts.maxRounds, "--max-rounds", 3),
+        timeoutMs: posInt(opts.timeout, "--timeout", 300) * 1000,
+        pollMs: posInt(opts.pollInterval, "--poll-interval", 5) * 1000,
+        async: Boolean(opts.async),
+    });
+    console.log(JSON.stringify(output, null, 2));
+    process.exit(exitCode);
+});
 intel
     .command("coverage")
     .description("GET /v1/system/subreddit-intelligence/coverage(纯读覆盖率评估:posts/comments/subreddits/evidence 各维 available vs required)")