@geoly-ai/social-hub-cli 0.3.2 → 0.3.4

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.3.4] - 2026-07-31
+
+### Added
+
+- 写作矩阵 P0-C —— 五项写作前置门与返工机制(vendored)
+- 客户交付 Phase1 Wave2-A —— SDK/CLI 接 Block3 client-delivery API
+
+## [0.3.3] - 2026-07-31
+
+### Fixed
+
+- 补 hot-posts↔Arctic history 跨 skill 划界 —— 历史帖别误用 Hub 缓存
+
 ## [0.3.2] - 2026-07-31
 
 ### Added

package/dist/client-delivery.test.d.ts

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

package/dist/client-delivery.test.d.ts.map

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

package/dist/client-delivery.test.js

@@ -0,0 +1,201 @@
+/**
+ * Integration tests for the `client-delivery` CLI command group:
+ * - staff + client subcommands register on the program;
+ * - request-changes reads its body via --json-file (Windows-friendly) and
+ *   forwards it to the SDK;
+ * - approve forwards the CAS expectedRevisionHash and a 409 (hash conflict)
+ *   propagates faithfully instead of being swallowed;
+ * - list-bundles forwards the required brandId filter.
+ */
+import { beforeAll, afterEach, describe, expect, it, vi } from "vitest";
+import { writeFileSync, mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const clientDeliveryRequestChanges = vi
+    .fn()
+    .mockResolvedValue({ revision: {} });
+const clientDeliveryApproveRevision = vi
+    .fn()
+    .mockResolvedValue({ revision: {} });
+const clientDeliveryListBundles = vi.fn().mockResolvedValue({ items: [] });
+vi.mock("@geoly-ai/social-hub-sdk", () => ({
+    SocialHubClient: vi.fn(),
+    getSocialHubHealth: vi.fn(),
+}));
+vi.mock("./client.js", () => ({
+    requireClient: () => ({
+        clientDeliveryRequestChanges,
+        clientDeliveryApproveRevision,
+        clientDeliveryListBundles,
+    }),
+    resolveTeamId: (t) => t ?? "team-1",
+    getBaseUrl: () => "http://localhost",
+}));
+let program;
+beforeAll(async () => {
+    program = (await import("./index.js")).program;
+    vi.spyOn(console, "log").mockImplementation(() => { });
+}, 30000);
+function group() {
+    return program.commands.find((c) => c.name() === "client-delivery");
+}
+function subNames() {
+    return group()?.commands.map((c) => c.name()) ?? [];
+}
+function subCmd(name) {
+    return group()?.commands.find((c) => c.name() === name);
+}
+afterEach(() => {
+    clientDeliveryRequestChanges.mockClear();
+    clientDeliveryApproveRevision.mockClear();
+    clientDeliveryListBundles.mockClear();
+    // Commander stores parsed option values on the singleton command; clear them
+    // so a value from one parseAsync run does not leak into the next.
+    for (const name of ["request-changes", "approve", "list-bundles"]) {
+        const cmd = subCmd(name);
+        for (const key of ["json", "jsonFile", "expectedHash", "note", "brand"]) {
+            cmd?.setOptionValue(key, undefined);
+        }
+    }
+});
+describe("client-delivery command registration", () => {
+    it("registers the group", () => {
+        expect(program.commands.map((c) => c.name())).toContain("client-delivery");
+    });
+    it("registers staff + client subcommands", () => {
+        const names = subNames();
+        for (const expected of [
+            // staff
+            "create-bundle",
+            "upsert-item",
+            "create-revision",
+            "submit-revision",
+            "create-product",
+            "create-fact-version",
+            "activate-fact-version",
+            "create-policy-version",
+            "activate-policy-version",
+            // client
+            "list-bundles",
+            "get-bundle",
+            "list-items",
+            "get-item",
+            "list-revisions",
+            "get-revision",
+            "list-comments",
+            "list-events",
+            "approve",
+            "request-changes",
+            "add-comment",
+            "resolve-comment",
+            "create-client-fact-version",
+        ]) {
+            expect(names).toContain(expected);
+        }
+    });
+});
+describe("client-delivery request-changes JSON input", () => {
+    const body = {
+        expectedRevisionHash: "hash-abc",
+        comments: [{ fieldKey: "title", body: "shorten" }],
+    };
+    function tmpFile() {
+        const dir = mkdtempSync(join(tmpdir(), "cd-json-"));
+        const file = join(dir, "body.json");
+        writeFileSync(file, JSON.stringify(body), "utf8");
+        return file;
+    }
+    it("reads body from --json-file and forwards to the SDK", async () => {
+        const file = tmpFile();
+        await program.parseAsync([
+            "node",
+            "social-hub",
+            "client-delivery",
+            "request-changes",
+            "--revision",
+            "r-1",
+            "--json-file",
+            file,
+        ]);
+        expect(clientDeliveryRequestChanges).toHaveBeenCalledWith("team-1", "r-1", body);
+    });
+    it("reads body from -j @file", async () => {
+        const file = tmpFile();
+        await program.parseAsync([
+            "node",
+            "social-hub",
+            "client-delivery",
+            "request-changes",
+            "--revision",
+            "r-1",
+            "-j",
+            `@${file}`,
+        ]);
+        expect(clientDeliveryRequestChanges).toHaveBeenCalledWith("team-1", "r-1", body);
+    });
+});
+describe("client-delivery approve (CAS)", () => {
+    it("forwards --expected-hash as expectedRevisionHash", async () => {
+        await program.parseAsync([
+            "node",
+            "social-hub",
+            "client-delivery",
+            "approve",
+            "--revision",
+            "r-1",
+            "--expected-hash",
+            "hash-abc",
+            "--note",
+            "lgtm",
+        ]);
+        expect(clientDeliveryApproveRevision).toHaveBeenCalledWith("team-1", "r-1", {
+            expectedRevisionHash: "hash-abc",
+            note: "lgtm",
+        });
+    });
+    it("propagates a 409 hash conflict instead of swallowing it", async () => {
+        clientDeliveryApproveRevision.mockRejectedValueOnce(new Error("HTTP 409: revision changed; reload before deciding"));
+        await expect(program.parseAsync([
+            "node",
+            "social-hub",
+            "client-delivery",
+            "approve",
+            "--revision",
+            "r-1",
+            "--expected-hash",
+            "stale",
+        ])).rejects.toThrow(/HTTP 409/);
+    });
+    it("propagates a 403 (api_key rejected; decision needs a user credential)", async () => {
+        // Client decisions require an auth-login user; a static api_key is refused
+        // server-side and the SDK surfaces it as HTTP 403. The CLI must not swallow
+        // it — credentials are decided by `auth login`, the CLI only relays.
+        clientDeliveryApproveRevision.mockRejectedValueOnce(new Error("HTTP 403: this action requires an authenticated user"));
+        await expect(program.parseAsync([
+            "node",
+            "social-hub",
+            "client-delivery",
+            "approve",
+            "--revision",
+            "r-1",
+            "--expected-hash",
+            "hash-abc",
+        ])).rejects.toThrow(/HTTP 403/);
+    });
+});
+describe("client-delivery list-bundles", () => {
+    it("forwards the required brandId filter", async () => {
+        await program.parseAsync([
+            "node",
+            "social-hub",
+            "client-delivery",
+            "list-bundles",
+            "--brand",
+            "brand-9",
+        ]);
+        expect(clientDeliveryListBundles).toHaveBeenCalledWith("team-1", {
+            brandId: "brand-9",
+        });
+    });
+});
+//# sourceMappingURL=client-delivery.test.js.map

package/dist/client-delivery.test.js.map

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

package/dist/cmd-manifest.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-07-31T06:25:46.989Z",
-  "cliVersion": "0.3.2",
+  "generatedAt": "2026-07-31T10:50:16.756Z",
+  "cliVersion": "0.3.4",
   "commands": [
     "accounts",
     "accounts brand-bindings",
@@ -121,6 +121,29 @@
     "campaigns get",
     "campaigns list",
     "campaigns update",
+    "client-delivery",
+    "client-delivery activate-fact-version",
+    "client-delivery activate-policy-version",
+    "client-delivery add-comment",
+    "client-delivery approve",
+    "client-delivery create-bundle",
+    "client-delivery create-client-fact-version",
+    "client-delivery create-fact-version",
+    "client-delivery create-policy-version",
+    "client-delivery create-product",
+    "client-delivery create-revision",
+    "client-delivery get-bundle",
+    "client-delivery get-item",
+    "client-delivery get-revision",
+    "client-delivery list-bundles",
+    "client-delivery list-comments",
+    "client-delivery list-events",
+    "client-delivery list-items",
+    "client-delivery list-revisions",
+    "client-delivery request-changes",
+    "client-delivery resolve-comment",
+    "client-delivery submit-revision",
+    "client-delivery upsert-item",
     "comment-drafts",
     "comment-drafts create",
     "comment-drafts delete",

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;AAoCpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AA+8D9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AA2/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;AA+1ED,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+CpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AA43E9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AA2/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;AA+1ED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -1208,6 +1208,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