@geoly-ai/social-hub-cli 0.3.3 → 0.3.5

package/dist/index.js

@@ -6,6 +6,7 @@ import { registerAccountsExtensions, registerAuthAndConfig, registerAuthzEvaluat
 import { registerAdminCommands } from "./register-admin.js";
 import { registerSubredditStyleCommands } from "./register-subreddit-style.js";
 import { registerContentClassificationCommands } from "./register-content-classification.js";
+import { registerNotifyCommands } from "./register-notify.js";
 import { assertApplyOrDryRun } from "./dry-run.js";
 import { withPermissionGate } from "./permission-runner.js";
 import { registerBatchAndExport } from "./register-batch.js";
@@ -33,6 +34,7 @@ registerAgentContext(program);
 registerAdminCommands(program);
 registerSubredditStyleCommands(program);
 registerContentClassificationCommands(program);
+registerNotifyCommands(program);
 registerBatchAndExport(program);
 program
     .command("health")
@@ -357,6 +359,27 @@ reddit
     }, { fetchAll: Boolean(opts.all) });
     console.log(JSON.stringify(res, null, 2));
 });
+reddit
+    .command("team-buckets")
+    .description("GET /v1/system/reddit-post-team-buckets(归属桶:未配置/外部)。外部来源帖回填前先用它拿桶 UUID")
+    .option("--slug <slug>", "只输出该 slug 的桶(便于脚本精确取一个)")
+    .option("--id-only", "只输出 UUID(每行一个),便于 shell 变量赋值")
+    .action(async (opts) => {
+    const res = await requireClient().listRedditPostTeamBuckets();
+    const items = opts.slug
+        ? res.items.filter((item) => item.slug === opts.slug)
+        : res.items;
+    if (opts.slug && items.length === 0) {
+        console.error(`no team bucket with slug=${opts.slug}(可先不带 --slug 列出全部）`);
+        process.exit(1);
+    }
+    if (opts.idOnly) {
+        for (const item of items)
+            console.log(item.id);
+        return;
+    }
+    console.log(JSON.stringify({ items }, null, 2));
+});
 reddit
     .command("create-snapshot")
     .description("POST /reddit-post-snapshots（手工补录）")
@@ -1208,6 +1231,285 @@ commentDrafts
     const res = await requireClient().scheduleCommentDraft(resolveTeamId(opts.team), opts.draft, body);
     console.log(JSON.stringify(res, null, 2));
 });
+// --- 客户面内容审核（Client Content Delivery）---
+//
+// staff 管理面(clientDeliveryAdmin):建 bundle/item/revision + 产品/事实/政策。
+// 客户 portal 面(clientDelivery):读、决策(approve/request-changes,走 CAS
+// expectedRevisionHash;不符 → 409)、字段级评论。**客户决策/评论/事实提交须用 user 凭证
+// (`social-hub auth login`),api_key 会被服务端拒**——CLI 如实透传服务端错误。
+const clientDelivery = program
+    .command("client-delivery")
+    .description("客户面内容审核交付（bundle/item/revision + 客户 approve/request-changes；决策须 user 凭证）");
+// ── staff 管理面 ──────────────────────────────────────────────────────────────
+clientDelivery
+    .command("create-bundle")
+    .description("POST client-delivery/bundles — staff 建 bundle")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .option("-j, --json <json>", "{ brandId, bundleCode, name, clientDueAt? }。也可 -j @<path> / -j -(stdin)")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一(Windows 友好)")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryCreateBundle(resolveTeamId(opts.team), body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("upsert-item")
+    .description("POST client-delivery/bundles/:id/items — staff upsert 条目(帖/评 + 矩阵字段)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--bundle <uuid>", "Bundle UUID")
+    .option("-j, --json <json>", "{ kind(post|comment), itemCode, contentDraftId?, commentDraftId?, ordinal?, boundProductId?, ...矩阵字段 }")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 -);与 -j 二选一")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryUpsertItem(resolveTeamId(opts.team), opts.bundle, body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("create-revision")
+    .description("POST client-delivery/items/:id/revisions — staff 建不可变送审快照")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--item <uuid>", "Item UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryCreateRevision(resolveTeamId(opts.team), opts.item);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("submit-revision")
+    .description("POST client-delivery/revisions/:id/submit — staff 送审(not_submitted|withdrawn → pending)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .option("--note <text>", "送审备注(可选)")
+    .action(async (opts) => {
+    const body = {};
+    if (opts.note !== undefined)
+        body.note = opts.note;
+    const res = await requireClient().clientDeliverySubmitRevision(resolveTeamId(opts.team), opts.revision, body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("create-product")
+    .description("POST client-delivery/products — staff 建产品身份")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .option("-j, --json <json>", "{ brandId, sku, brandRegistryId?, modelName?, market?, status? }")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 -);与 -j 二选一")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryCreateProduct(resolveTeamId(opts.team), body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("create-fact-version")
+    .description("POST client-delivery/products/:productId/fact-versions（staff 面）— provenance 默认 staff")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--product <uuid>", "Product UUID")
+    .option("-j, --json <json>", "{ provenance?, positioning?, materials?, priceAmount?, priceCurrency?, inventoryStatus?, factsJson?, effectiveAt?, expiresAt?, sourceRef?, ... }")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 -);与 -j 二选一")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryCreateFactVersion(resolveTeamId(opts.team), opts.product, body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("activate-fact-version")
+    .description("POST client-delivery/products/:productId/fact-versions/:fvId/activate — staff 激活 + stale 传播")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--product <uuid>", "Product UUID")
+    .requiredOption("--fact-version <uuid>", "Fact version UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryActivateFactVersion(resolveTeamId(opts.team), opts.product, opts.factVersion);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("create-policy-version")
+    .description("POST client-delivery/policy-versions — staff 建品牌内容政策版本")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .option("-j, --json <json>", "{ brandId, market?, provenance?, policyJson?, effectiveAt? }")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 -);与 -j 二选一")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryCreatePolicyVersion(resolveTeamId(opts.team), body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("activate-policy-version")
+    .description("POST client-delivery/policy-versions/:id/activate — staff 激活政策版本")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--policy-version <uuid>", "Policy version UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryActivatePolicyVersion(resolveTeamId(opts.team), opts.policyVersion);
+    console.log(JSON.stringify(res, null, 2));
+});
+// ── 客户 portal 面(读/决策/评论)──────────────────────────────────────────────
+clientDelivery
+    .command("list-bundles")
+    .description("GET client-delivery/bundles — 客户面 bundle 列表(brandId 必填)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--brand <uuid>", "brandId（服务端必填）")
+    .option("--status <st>", "状态过滤:open | closed | cancelled")
+    .option("-n, --limit <n>", "limit")
+    .option("--offset <n>", "offset")
+    .action(async (opts) => {
+    const params = { brandId: opts.brand };
+    if (opts.status)
+        params.status = opts.status;
+    if (opts.limit !== undefined)
+        params.limit = Number(opts.limit);
+    if (opts.offset !== undefined)
+        params.offset = Number(opts.offset);
+    const res = await requireClient().clientDeliveryListBundles(resolveTeamId(opts.team), params);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("get-bundle")
+    .description("GET client-delivery/bundles/:id")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--bundle <uuid>", "Bundle UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryGetBundle(resolveTeamId(opts.team), opts.bundle);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("list-items")
+    .description("GET client-delivery/bundles/:id/items")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--bundle <uuid>", "Bundle UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryListItems(resolveTeamId(opts.team), opts.bundle);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("get-item")
+    .description("GET client-delivery/items/:id")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--item <uuid>", "Item UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryGetItem(resolveTeamId(opts.team), opts.item);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("list-revisions")
+    .description("GET client-delivery/items/:id/revisions")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--item <uuid>", "Item UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryListRevisions(resolveTeamId(opts.team), opts.item);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("get-revision")
+    .description("GET client-delivery/revisions/:id（含 sourceContentHash 作 approve/request-changes 的 CAS 凭证）")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryGetRevision(resolveTeamId(opts.team), opts.revision);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("list-comments")
+    .description("GET client-delivery/revisions/:id/comments")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryListComments(resolveTeamId(opts.team), opts.revision);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("list-events")
+    .description("GET client-delivery/revisions/:id/events — 决策事件链")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryListEvents(resolveTeamId(opts.team), opts.revision);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("approve")
+    .description("POST client-delivery/revisions/:id/approve — 客户批准(CAS;须 user 凭证,api_key 被拒;hash 不符 → 409)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .requiredOption("--expected-hash <hash>", "expectedRevisionHash（取自 get-revision 的 sourceContentHash；不符 → 409）")
+    .option("--note <text>", "批准备注(可选)")
+    .action(async (opts) => {
+    const body = {
+        expectedRevisionHash: opts.expectedHash,
+    };
+    if (opts.note !== undefined)
+        body.note = opts.note;
+    const res = await requireClient().clientDeliveryApproveRevision(resolveTeamId(opts.team), opts.revision, body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("request-changes")
+    .description("POST client-delivery/revisions/:id/request-changes — 客户请求修改 + 字段级评论(CAS;须 user 凭证;hash 不符 → 409)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .option("-j, --json <json>", "{ expectedRevisionHash, comments:[{ fieldKey, quotedText?, body }], note? }。也可 -j @<path> / -j -")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 -);与 -j 二选一")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryRequestChanges(resolveTeamId(opts.team), opts.revision, body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("add-comment")
+    .description("POST client-delivery/revisions/:id/comments — 客户字段级讨论(须 user 凭证)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--revision <uuid>", "Revision UUID")
+    .requiredOption("--field-key <key>", "字段定位(如 title/body/price)")
+    .requiredOption("--body <text>", "评论正文")
+    .option("--quoted-text <text>", "引用的原文片段(可选)")
+    .action(async (opts) => {
+    const body = {
+        fieldKey: opts.fieldKey,
+        body: opts.body,
+    };
+    if (opts.quotedText !== undefined)
+        body.quotedText = opts.quotedText;
+    const res = await requireClient().clientDeliveryAddComment(resolveTeamId(opts.team), opts.revision, body);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("resolve-comment")
+    .description("POST client-delivery/comments/:id/resolve — 客户关闭讨论(幂等;须 user 凭证)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--comment <uuid>", "Comment UUID")
+    .action(async (opts) => {
+    const res = await requireClient().clientDeliveryResolveComment(resolveTeamId(opts.team), opts.comment);
+    console.log(JSON.stringify(res, null, 2));
+});
+clientDelivery
+    .command("create-client-fact-version")
+    .description("POST client-delivery/products/:productId/fact-versions（客户面）— provenance 强制 client(须 user 凭证)")
+    .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
+    .requiredOption("--product <uuid>", "Product UUID")
+    .option("-j, --json <json>", "{ positioning?, materials?, priceAmount?, priceCurrency?, inventoryStatus?, factsJson?, effectiveAt?, expiresAt?, sourceRef?, ... }")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 -);与 -j 二选一")
+    .action(async (opts) => {
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
+    const res = await requireClient().clientDeliveryCreateClientFactVersion(resolveTeamId(opts.team), opts.product, body);
+    console.log(JSON.stringify(res, null, 2));
+});
 // --- compliance ---
 const compliance = program.command("compliance").description("合规 / 风控");
 compliance