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

package/dist/voc-acquire.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=voc-acquire.test.d.ts.map

package/dist/voc-acquire.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voc-acquire.test.d.ts","sourceRoot":"","sources":["../src/voc-acquire.test.ts"],"names":[],"mappings":""}

package/dist/voc-acquire.test.js

@@ -0,0 +1,243 @@
+import { describe, expect, it, vi } from "vitest";
+import { orchestrateVocAcquire } from "./index.js";
+// 受控时钟:每次 now() 前进一固定步长;sleep 也推进时钟(便于 deadline 断言)。
+function fakeClock(stepMs = 1000) {
+    let t = 0;
+    return {
+        now: () => t,
+        sleep: async (ms) => {
+            t += ms || stepMs;
+        },
+        advance: (ms) => {
+            t += ms;
+        },
+    };
+}
+const coverage = (satisfied) => ({ overall: { satisfied } });
+function baseParams(clock, over = {}) {
+    return {
+        query: {},
+        requirements: {},
+        maxRounds: 3,
+        timeoutMs: 60_000,
+        pollMs: 1_000,
+        async: false,
+        now: clock.now,
+        sleep: clock.sleep,
+        ...over,
+    };
+}
+describe("orchestrateVocAcquire", () => {
+    it("第一轮已满足 → exitCode 0", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(true),
+                dispatched: [],
+            })),
+            getIntelRunProgress: vi.fn(),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(0);
+        expect(output.status).toBe("satisfied");
+        expect(client.getIntelRunProgress).not.toHaveBeenCalled();
+    });
+    it("受限主体无预检:无 evidence create 时 vocQuery 首次 403 → 抛出(命令层退 1),派发前无副作用", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => {
+                throw new Error("HTTP 403: forbidden");
+            }),
+            getIntelRunProgress: vi.fn(),
+        };
+        // 无角色预检:错误由服务端 403 抛出,orchestrate 不吞(非 deadline)→ 命令层退 1。
+        await expect(orchestrateVocAcquire(client, baseParams(clock))).rejects.toThrow(/403/);
+        expect(client.getIntelRunProgress).not.toHaveBeenCalled();
+    });
+    it("派发→轮询到终态→重算满足 → exitCode 0", async () => {
+        const clock = fakeClock();
+        let progressCalls = 0;
+        const client = {
+            vocQuery: vi
+                .fn()
+                .mockResolvedValueOnce({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }, { runId: "r1" }],
+            })
+                .mockResolvedValueOnce({ coverage: coverage(true), dispatched: [] }),
+            getIntelRunProgress: vi.fn(async () => {
+                progressCalls += 1;
+                return { status: progressCalls >= 2 ? "succeeded" : "running" };
+            }),
+        };
+        const { exitCode } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(0);
+        // dispatched 去重:只轮询 r1 一次(直到终态)。
+        expect(client.vocQuery).toHaveBeenCalledTimes(2); // dispatch 轮 + 最终验收
+    });
+    it("--async 只派一轮 → exitCode 2(不轮询)", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })),
+            getIntelRunProgress: vi.fn(),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock, { async: true }));
+        expect(exitCode).toBe(2);
+        expect(output.status).toBe("dispatched");
+        expect(client.getIntelRunProgress).not.toHaveBeenCalled();
+    });
+    it("run 进度 403 → exitCode 1(能派不能读,不误当完成)", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })),
+            getIntelRunProgress: vi.fn(async () => {
+                throw new Error("HTTP 403: forbidden");
+            }),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(1);
+        expect(output.status).toBe("forbidden");
+    });
+    it("网络错误重试、不误删 pending;终态后完成", async () => {
+        const clock = fakeClock();
+        let calls = 0;
+        const client = {
+            vocQuery: vi
+                .fn()
+                .mockResolvedValueOnce({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })
+                .mockResolvedValueOnce({ coverage: coverage(true), dispatched: [] }),
+            getIntelRunProgress: vi.fn(async () => {
+                calls += 1;
+                if (calls === 1)
+                    throw new Error("network ECONNRESET"); // 无 HTTP status
+                return { status: "succeeded" };
+            }),
+        };
+        const { exitCode } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(0);
+        expect(calls).toBe(2); // 第一次网络错保留 pending,第二次成功。
+    });
+    it("轮询超时 → exitCode 2 + pendingRunIds", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })),
+            getIntelRunProgress: vi.fn(async () => ({ status: "running" })), // 永不终态
+        };
+        // 短超时:sleep 每次推进 1000ms,几轮后越界。
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock, { timeoutMs: 3_000 }));
+        expect(exitCode).toBe(2);
+        expect(output.status).toBe("timeout");
+        expect(output.pendingRunIds).toEqual(["r1"]);
+    });
+    it("多轮后仍不满足 → exitCode 2 + externalImportMayBeRequired", async () => {
+        const clock = fakeClock();
+        const client = {
+            // 每轮都派发但从不满足;终态立即达成推进轮次。
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })),
+            getIntelRunProgress: vi.fn(async () => ({ status: "succeeded" })),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock, { maxRounds: 2 }));
+        expect(exitCode).toBe(2);
+        expect(output.status).toBe("unsatisfied");
+        expect(output.externalImportMayBeRequired).toBe(true);
+        expect(output.recommendedCommand).toContain("evidence-import");
+    });
+    it("run 进度 404 → exitCode 1(run_not_found)", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })),
+            getIntelRunProgress: vi.fn(async () => {
+                throw new Error("HTTP 404: not found");
+            }),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(1);
+        expect(output.status).toBe("run_not_found");
+    });
+    it("请求永不 resolve → 真实定时器触发 → timeout 2(严格有界,race)", async () => {
+        // 用真实时钟(不注入 now/sleep):withDeadline 的真实 setTimeout(rem) 会先于永不 resolve 的请求触发。
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [{ runId: "r1" }],
+            })),
+            getIntelRunProgress: vi.fn(() => new Promise(() => { })), // 永不 resolve
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, {
+            query: {},
+            requirements: {},
+            maxRounds: 3,
+            timeoutMs: 80, // 真实 80ms 后定时器触发
+            pollMs: 10,
+            async: false,
+        });
+        expect(exitCode).toBe(2);
+        expect(output.status).toBe("timeout");
+    });
+    it("deadline 耗尽后 withDeadline 短路、不再发起 vocQuery 请求(先查 remaining 再调 thunk)", async () => {
+        // now() 每次调用推进 500ms;timeout 1000ms → 最终验收 vocQuery 前 remaining<=0,thunk 不被调用
+        //(旧 eager-Promise 实现会多调一次;此断言防其回归)。
+        let t = 0;
+        const now = () => {
+            t += 500;
+            return t;
+        };
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [], // 无 runId → 不轮询,直接进下一步/最终验收
+            })),
+            getIntelRunProgress: vi.fn(),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, {
+            query: {},
+            requirements: {},
+            maxRounds: 5,
+            timeoutMs: 1000,
+            pollMs: 10,
+            async: false,
+            now,
+            sleep: async () => { },
+        });
+        // deadline 计算(now→t=500)→ round1 vocQuery withDeadline(now→t=1000)→ dispatched 空 break →
+        // 最终验收 vocQuery withDeadline(now→t=1500,remaining=1500-1500=0<=0)→ VocDeadlineError → timeout。
+        // deadline=500+1000=1500,故最终验收短路不发起。
+        expect(exitCode).toBe(2);
+        expect(output.status).toBe("timeout");
+        // 关键:只调过 1 次(round1 dispatch);最终验收在 remaining<=0 时短路,没发第 2 次请求。
+        expect(client.vocQuery).toHaveBeenCalledTimes(1);
+    });
+    it("缺口但无可派发(runId 空)→ 直接进最终验收、不满足 → exitCode 2", async () => {
+        const clock = fakeClock();
+        const client = {
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [],
+            })),
+            getIntelRunProgress: vi.fn(),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(2);
+        expect(output.status).toBe("unsatisfied");
+        expect(client.getIntelRunProgress).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=voc-acquire.test.js.map

package/dist/voc-acquire.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voc-acquire.test.js","sourceRoot":"","sources":["../src/voc-acquire.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoly-ai/social-hub-cli",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "type": "module",
   "description": "social-hub CLI for Social Ops Hub",
   "repository": {
@@ -23,7 +23,7 @@
   "dependencies": {
     "commander": "^12.1.0",
     "@geoly-ai/social-hub-authz": "0.0.7",
-    "@geoly-ai/social-hub-sdk": "0.0.36"
+    "@geoly-ai/social-hub-sdk": "0.0.37"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",

package/skills/manifest.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "package": "social-ops-hub",
-  "cliVersion": "0.2.19",
+  "cliVersion": "0.2.21",
   "repository": "social-ops-hub",
   "publish": {
     "registry": "https://skill.sh",

package/skills/social-hub-intelligence/SKILL.md

@@ -53,8 +53,12 @@ social-hub intelligence comments [--post-id t3_xxx] [--subreddit espresso] [--ke
 ```bash
 # 评论回灌(批≤200;redditCommentId=t1_*/postId=t3_*;逐条拒收报告不整批拒)
 social-hub intelligence comments-import --file batch.json
-# batch.json: {"items":[{"redditCommentId":"t1_x","postId":"t3_y","subreddit":"espresso","body":"..."}],
+# batch.json: {"items":[{"redditCommentId":"t1_x","postId":"t3_y","subreddit":"espresso","body":"...",
+#                "label":{"intent":"complaint","sentiment":"negative","confidence":0.9},"matchedTerms":["aporro"]}],
 #              "provenance":{"provider":"matrix_voc","collectorVersion":"2.12.19","sourceUrl":"https://..."}}
+#   可选 label(intent/sentiment/confidence 须齐全):矩阵 skill 已自行 LLM 标注就直接带→写入即标记 labeled
+#   (labelModel=external_import),异步标注 cron 自动跳过、无需再等标注任务;缺 label 则留待 cron 标注。
+#   仅新增 label(内容未变)也算 update 不丢弃。intent 枚举见 comments 查询的 --intent。matchedTerms=关键词命中。
 # 证据回灌(单条观测;Hub 派生状态)
 social-hub intelligence evidence-import -j '{"subreddit":"espresso","evidenceType":"flair","observation":{"contentMd":"- Help\n- Gear"},"provenance":{"sourceUrl":"https://www.reddit.com/r/espresso/","provider":"matrix_voc","collectorVersion":"2.12.19"}}'
 # 证据批量回灌(批≤200;多缺口一次导入;逐条独立成败,返回 {total,imported,deduped,rejected,results[]})
@@ -94,6 +98,22 @@ social-hub intelligence voc-query --brand-keywords aporro --subreddits espresso
 满足直接消费系统数据;不满足带 --dispatch-on-gap 重发,拿 runIds 经 runs-list
 轮询终态后再消费——"先查 Social Hub,缺口才抓 Reddit"落地为一次调用。
 
+**一键有界编排 `voc-acquire`**(把上面循环封装成一条命令,免手工轮询 runs-list):
+
+```bash
+social-hub intelligence voc-acquire --brand-keywords aporro --subreddits espresso \
+  --need-comments --need-rules-evidence --max-rounds 3 --timeout 300 --poll-interval 5
+```
+
+循环 voc-query --dispatch-on-gap → 轮询本轮 run 到终态 → 重算 coverage 验收 → 缺口再派一轮(≤max-rounds)。
+**退出码**:`0`=coverage 满足;`2`=尚未满足(超时 / 多轮后仍缺口——非命令失败,自动化据此判定);
+`1`=错误(鉴权/格式/网络)。`--async` 只派第一轮不等待(退 2)。**受限主体亦可**(权限由服务端强制:
+需 evidence create 派发 + 该 dimension read 轮询进度;无权则对应请求 403/404→退 1)。
+退 2 且 `externalImportMayBeRequired:true` 时按 `recommendedCommand` 走本地采集 + evidence-import 回灌
+——注:CLI 无本地 Reddit collector,**外部采集(Firecrawl/本地)+ 回灌仍是独立步骤**(voc-acquire 只做
+Hub-native 派发+验收,配额耗尽/无命中时诚实交回 recommendedCommand,由采集任务自行 evidence-import/
+comments-import/posts-import 回灌;这是架构边界,非一条命令能完成所有外部采集)。
+
 ## Coverage 覆盖率评估(cache-first 决策依据,纯读)
 
 ```bash