@geoly-ai/social-hub-cli 0.2.18 → 0.2.20

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,253 @@
+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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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("client 角色在派发前被拒 → exitCode 1(不调 vocQuery)", async () => {
+        const clock = fakeClock();
+        const client = {
+            getAuthContext: vi.fn(async () => ({ role: "client" })),
+            vocQuery: vi.fn(),
+            getIntelRunProgress: vi.fn(),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, baseParams(clock));
+        expect(exitCode).toBe(1);
+        expect(output.status).toBe("forbidden");
+        expect(client.vocQuery).not.toHaveBeenCalled();
+    });
+    it("派发→轮询到终态→重算满足 → exitCode 0", async () => {
+        const clock = fakeClock();
+        let progressCalls = 0;
+        const client = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "senior" })),
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            // 每轮都派发但从不满足;终态立即达成推进轮次。
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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 1200ms → 最终验收 vocQuery 前 remaining<=0,thunk 不被调用
+        //(旧 eager-Promise 实现会多调一次;此断言防其回归)。
+        let t = 0;
+        const now = () => {
+            t += 500;
+            return t;
+        };
+        const client = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            vocQuery: vi.fn(async () => ({
+                coverage: coverage(false),
+                dispatched: [], // 无 runId → 不轮询,直接进下一步/最终验收
+            })),
+            getIntelRunProgress: vi.fn(),
+        };
+        const { exitCode, output } = await orchestrateVocAcquire(client, {
+            query: {},
+            requirements: {},
+            maxRounds: 5,
+            timeoutMs: 1200,
+            pollMs: 10,
+            async: false,
+            now,
+            sleep: async () => { },
+        });
+        // getAuthContext(1 次 now)+ round1 vocQuery(now)→ dispatched 空 break → 最终验收 vocQuery
+        // 在 remaining<=0 时抛 VocDeadlineError → timeout,不再真正发起。
+        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 = {
+            getAuthContext: vi.fn(async () => ({ role: "manager" })),
+            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.18",
+  "version": "0.2.20",
   "type": "module",
   "description": "social-hub CLI for Social Ops Hub",
   "repository": {
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "commander": "^12.1.0",
-    "@geoly-ai/social-hub-sdk": "0.0.35",
-    "@geoly-ai/social-hub-authz": "0.0.7"
+    "@geoly-ai/social-hub-authz": "0.0.7",
+    "@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.18",
+  "cliVersion": "0.2.20",
   "repository": "social-ops-hub",
   "publish": {
     "registry": "https://skill.sh",

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

@@ -65,6 +65,9 @@ social-hub intelligence evidence-import --file evidence.json
 # 热帖批量回灌(批≤200;每条 watchlistId 做品牌归因→进 subreddit_hot_post_snapshots;逐条拒收报告)
 social-hub intelligence posts-import --file posts.json
 # posts.json: {"items":[{"watchlistId":"<uuid>","subreddit":"espresso","title":"...","permalink":"https://www.reddit.com/r/espresso/comments/x/y/","score":12,"commentsCount":3}]}
+#   返回 {createdCount(净新增),updatedCount(已有帖内容变),unchangedCount(内容未变),rejectedCount,
+#        importedCount=前三者和(兼容),results[{index,id,outcome}]}——created 才是净新增,无需抓前后比 permalink。
+#   分类=material(标题/正文/flair/作者)变化;指标(score/comments)变不算 updated;陈旧回放不覆盖较新数据。
 ```
 
 **热帖归因**:`watchlistId` 是品牌归因主键(watchlist 挂 brandId);受限主体回灌时该条
@@ -91,6 +94,18 @@ 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)。**第一版仅 unrestricted 角色**(client 恒拒)。
+退 2 且 `externalImportMayBeRequired:true` 时按 `recommendedCommand` 走本地采集 + evidence-import 回灌。
+
 ## Coverage 覆盖率评估(cache-first 决策依据,纯读)
 
 ```bash
@@ -128,8 +143,11 @@ social-hub intelligence evidence-status --subreddit espresso
 **8 类证据**:about / rules / wiki / submit_text / pinned / flair / page_signals /
 installed_apps。**状态语义**:`available`=抓到内容(含"规则为空"这类可确证的空);
 `not_visible`=页面明确无该项;`failed`=采集失败——**failed 不等于"没有规则"**,
-合规判断必须区分。`needsAcquisition=true` 表示无新鲜证据(从未采/过期/最近失败,
-看 lastAttemptAt/lastFailureReason 区分),先 evidence-fetch 再消费。TTL:
+合规判断必须区分。**采集完成度**:`needsAcquisition=true` 表示无新鲜的**已完成采集**证据
+(从未采/过期/仅 failed);**fresh not_visible 与 fresh available 一样算已完成 → needsAcquisition=false**
+(不再反复派发白吃额度),TTL 到期后 not_visible 才重新 needsAcquisition。**内容消费**另有
+`evidence-list --fresh-only` 只返 available(not_visible 无内容可消费)。看 lastAttemptAt/
+lastFailureReason 区分从未采/失败。TTL:
 rules/wiki/about/submit_text 30 天、pinned 24 小时、flair/page_signals/
 installed_apps 7 天。