@harrylabsj/kiwi 0.6.0 → 0.6.1

package/dist/product-catalog.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * `kiwi catalog serve` —— 启动独立 kiwi-catalog 服务（CURRENT-DOCS v0.7.0）。
+ *
+ * kiwi-catalog 是独立部署仓（~/coding/kiwi-catalog），console script 入口
+ * `kiwi-catalog-api`（pyproject [project.scripts]）。本命令以前台方式
+ * 转发启动该服务（stdio inherit），便于本地一体化开发；依赖检测：
+ * 未安装（ENOENT）→ fail-closed 提示 pip install。
+ *
+ * 缺省：--db ./kiwi-catalog.sqlite --host 127.0.0.1 --port 8600
+ * （与 kiwi-catalog 的缺省端口一致）。
+ */
+import { spawnSync } from "node:child_process";
+export interface CatalogServeOptions {
+    /** catalog SQLite 文件路径（缺省 ./kiwi-catalog.sqlite）。 */
+    db?: string;
+    host?: string;
+    port?: number;
+    /** 测试注入。 */
+    spawnImpl?: typeof spawnSync;
+}
+export interface CatalogServeResult {
+    ok: boolean;
+    /** spawn 前即失败的原因（如 kiwi-catalog 未安装）。 */
+    error?: string;
+    /** 服务是否已实际启动（Ctrl+C 停止视为正常，spawned=true）。 */
+    spawned?: boolean;
+}
+export declare function catalogServe(options?: CatalogServeOptions): CatalogServeResult;

package/dist/product-catalog.js

@@ -0,0 +1,60 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * `kiwi catalog serve` —— 启动独立 kiwi-catalog 服务（CURRENT-DOCS v0.7.0）。
+ *
+ * kiwi-catalog 是独立部署仓（~/coding/kiwi-catalog），console script 入口
+ * `kiwi-catalog-api`（pyproject [project.scripts]）。本命令以前台方式
+ * 转发启动该服务（stdio inherit），便于本地一体化开发；依赖检测：
+ * 未安装（ENOENT）→ fail-closed 提示 pip install。
+ *
+ * 缺省：--db ./kiwi-catalog.sqlite --host 127.0.0.1 --port 8600
+ * （与 kiwi-catalog 的缺省端口一致）。
+ */
+import { spawnSync } from "node:child_process";
+export function catalogServe(options = {}) {
+    const spawn = options.spawnImpl ?? spawnSync;
+    const args = [
+        "--db",
+        options.db ?? "./kiwi-catalog.sqlite",
+        "--host",
+        options.host ?? "127.0.0.1",
+        "--port",
+        String(options.port ?? 8600),
+    ];
+    // spawnSync 对 ENOENT 不抛异常——返回 { error: ENOENT, status: null }；
+    // Ctrl+C 停止则 status 为 null 且无 error（视为正常）。
+    const result = spawn("kiwi-catalog-api", args, { stdio: "inherit" });
+    if (result.error !== undefined) {
+        const code = result.error.code;
+        if (code === "ENOENT") {
+            return {
+                ok: false,
+                error: "kiwi-catalog-api 未安装——kiwi-catalog 是独立部署仓（~/coding/kiwi-catalog），" +
+                    "请先 `pip install -e ~/coding/kiwi-catalog` 再运行本命令",
+            };
+        }
+        return {
+            ok: false,
+            error: `kiwi-catalog-api 启动失败：${result.error.message}`,
+        };
+    }
+    if (result.status !== null && result.status !== 0) {
+        return { ok: false, error: `kiwi-catalog-api 退出码 ${result.status}（服务日志见上方输出）` };
+    }
+    return { ok: true, spawned: true };
+}
+//# sourceMappingURL=product-catalog.js.map

package/dist/product-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-catalog.js","sourceRoot":"","sources":["../src/product-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAmB/C,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG;QACX,MAAM;QACN,OAAO,CAAC,EAAE,IAAI,uBAAuB;QACrC,QAAQ;QACR,OAAO,CAAC,IAAI,IAAI,WAAW;QAC3B,QAAQ;QACR,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;KAC7B,CAAC;IACF,+DAA+D;IAC/D,2CAA2C;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAI,MAAM,CAAC,KAA2B,CAAC,IAAI,CAAC;QACtD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EACH,mEAAmE;oBACnE,kDAAkD;aACrD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,yBAAyB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;SACvD,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,MAAM,CAAC,MAAM,aAAa,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/product-cli.d.ts

@@ -28,7 +28,7 @@
  */
 import { spawnSync } from "node:child_process";
 /** 与 package.json / USAGE 同步的产品版本。 */
-export declare const PRODUCT_VERSION = "0.6.0";
+export declare const PRODUCT_VERSION = "0.6.1";
 /**
  * 缺省 kiwi-catalog 地址（单一来源，cli.ts 各处解析一致）。
  *

package/dist/product-cli.js

@@ -30,7 +30,7 @@ import { spawnSync } from "node:child_process";
 import { EXIT } from "./exit-codes.js";
 import { SHOPPING_CLI_COMPAT, compatRangeText, versionInRange } from "./product-compat.js";
 /** 与 package.json / USAGE 同步的产品版本。 */
-export const PRODUCT_VERSION = "0.6.0";
+export const PRODUCT_VERSION = "0.6.1";
 /**
  * 缺省 kiwi-catalog 地址（单一来源，cli.ts 各处解析一致）。
  *

package/dist/product-publish.d.ts

@@ -14,20 +14,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/**
- * `kiwi merchant publish` 编排（product-strategy rev1.1 §4.5/§19 D2）。
- *
- * 编排层在 kiwi 仓，调两仓能力（组件独立发布，§12）：
- *
- *   1. 确认/注册 owner Agent  → kiwi-catalog POST /v1/agent-catalog/agents/register
- *      （owner_token = HMAC-SHA256("kiwi-catalog-owner:" + merchant_id)，
- *       与 kiwi-catalog api/auth.py 逐字节一致；注册幂等 upsert）
- *   2. 触发 listing 发布      → 进程调用 shopping-cli
- *      （spawn `shopping listings publish-listings`，不建 HTTP 强依赖；
- *       digest 去重由 shopping-cli 镜像表保证幂等）
- *   3. 汇总分步状态           → fail-closed：agent 注册失败则短路
- *      （listings 依赖 owner agent 存在），listings 失败报错不假装全成功。
- */
 import { spawnSync } from "node:child_process";
 import type { AgentProfile } from "./config/profile.js";
 export interface MerchantPublishOptions {
@@ -35,13 +21,17 @@ export interface MerchantPublishOptions {
     profile: AgentProfile;
     /** kiwi-catalog base URL（缺省由调用方解析 KIWI_CATALOG_URL）。 */
     catalogBaseUrl: string;
-    /** KIWI_CATALOG_OWNER_TOKEN_SECRET（owner token 派生）。 */
-    ownerTokenSecret: string;
+    /** KIWI_CATALOG_OWNER_TOKEN_SECRET（owner token 派生，legacy）。 */
+    ownerTokenSecret?: string;
+    /** 商家随机 owner token（v12+ 双路径；优先于 HMAC 派生）。 */
+    ownerToken?: string;
     /** shopping-cli SQLite 数据库路径（listings publish-listings --db）。 */
     shoppingCliDb: string;
     /** shopping-cli 可执行名/路径（缺省 "shopping"）。 */
     shoppingCliPath?: string;
-    /** shopping-cli 的 merchant_id（缺省 = profile.agent_id；init 统一身份前的显式映射）。 */
+    /** shopping-cli 侧 merchant_id（投影过滤；缺省 = profile.agent_id）。
+     *  catalog 侧身份恒为 profile.agent_id——两者不同时（如 catalog 申请
+     *  审批身份配随机 owner token）用本字段显式映射投影侧。 */
     shoppingCliMerchant?: string;
     /** catalog 注册域名（缺省 KIWI_CATALOG_DOMAIN / merchant-{agent_id}.local）。 */
     catalogDomain?: string;
@@ -60,6 +50,9 @@ export interface StepListings {
     published?: number;
     skipped?: number;
     withdrawn?: number;
+    published_refs?: string[];
+    skipped_refs?: string[];
+    withdrawn_refs?: string[];
     errors?: string[];
     raw?: unknown;
 }

package/dist/product-publish.js

@@ -22,12 +22,15 @@
  *   1. 确认/注册 owner Agent  → kiwi-catalog POST /v1/agent-catalog/agents/register
  *      （owner_token = HMAC-SHA256("kiwi-catalog-owner:" + merchant_id)，
  *       与 kiwi-catalog api/auth.py 逐字节一致；注册幂等 upsert）
- *   2. 触发 listing 发布      → 进程调用 shopping-cli
- *      （spawn `shopping listings publish-listings`，不建 HTTP 强依赖；
- *       digest 去重由 shopping-cli 镜像表保证幂等）
+ *   2. 读投影并发布 listings  → spawn `shopping listings projections list`（只读）
+ *      取 public-only 投影 → 逐条直连 kiwi-catalog POST /v1/listings/publish
+ *      （v3.0 起 publish 面归独立 kiwi-catalog 服务，行级幂等在服务端；
+ *       owner token 直传优先，否则按 register 同公式 HMAC 派生）
+ *      随后 reconcile：投影中消失的商品 POST /v1/listings/{id}/withdraw
  *   3. 汇总分步状态           → fail-closed：agent 注册失败则短路
  *      （listings 依赖 owner agent 存在），listings 失败报错不假装全成功。
  */
+import { createHmac } from "node:crypto";
 import { spawnSync } from "node:child_process";
 import { registerCatalogAgent } from "./discovery/catalog-source/register.js";
 import { SHOPPING_CLI_COMPAT, compatRangeText, versionInRange } from "./product-compat.js";
@@ -42,14 +45,21 @@ function safeAgentId(agentId) {
  */
 export async function merchantPublish(options) {
     const profile = options.profile;
-    // 统一身份：agent 注册、merchant 查询、shopping-cli 发布必须用同一个
-    // merchant_id（kiwi-catalog 一商家一 agent + publish 校验 owner 绑定）。
-    // 缺省 = profile.agent_id；kiwi 身份与 shopping-cli merchant 不一致时
-    // 用 --shopping-cli-merchant 显式指定（D1 init 统一身份前的映射）。
-    const merchantId = options.shoppingCliMerchant ?? profile.agent_id;
+    // 双身份拆分（2026-08-08 修复）：catalog 侧身份与 shopping-cli 侧 merchant
+    // 是两个独立概念——
+    // - catalogMerchantId = profile.agent_id：agent 注册/复用、owner token
+    //   派生（HMAC）与校验、publish body merchant_id、自查端点（kiwi-catalog
+    //   一商家一 agent + publish 校验 owner 绑定都以此为准）；
+    // - shoppingMerchant = --shopping-cli-merchant ?? profile.agent_id：投影
+    //   过滤（shopping-cli 侧 merchant）。D1 init 统一身份后两者相同；显式
+    //   映射用于 catalog 申请审批身份（随机 owner token）与 shopping-cli
+    //   商家名不同的场景——原实现把映射项当成全局身份，导致随机 token
+    //   （KIWI_MERCHANT_TOKEN）下 publish 身份错乱。
+    const catalogMerchantId = profile.agent_id;
+    const shoppingMerchant = options.shoppingCliMerchant ?? profile.agent_id;
     const domain = options.catalogDomain ??
         process.env.KIWI_CATALOG_DOMAIN ??
-        `merchant-${safeAgentId(merchantId)}.local`;
+        `merchant-${safeAgentId(catalogMerchantId)}.local`;
     // ── Step 0: shopping-cli 版本兼容检查（D3 矩阵共同消费，fail-closed）──
     // 矩阵单一来源 = product-compat.ts；与 `kiwi doctor` 共同消费。
     const versionSpawn = options.spawnImpl ?? spawnSync;
@@ -101,7 +111,7 @@ export async function merchantPublish(options) {
     let catalogAgentId;
     let agentError;
     try {
-        const lookupUrl = `${baseUrl}/v1/agent-catalog/merchants/${encodeURIComponent(merchantId)}/agents`;
+        const lookupUrl = `${baseUrl}/v1/agent-catalog/merchants/${encodeURIComponent(catalogMerchantId)}/agents`;
         const lookup = await fetchImpl(lookupUrl, { signal: AbortSignal.timeout(15_000) });
         if (lookup.ok) {
             const body = (await lookup.json());
@@ -115,7 +125,8 @@ export async function merchantPublish(options) {
             const reg = await registerCatalogAgent({
                 catalogBaseUrl: options.catalogBaseUrl,
                 domain,
-                merchantId,
+                merchantId: catalogMerchantId,
+                ownerToken: options.ownerToken,
                 ownerTokenSecret: options.ownerTokenSecret,
                 agentCardUrl: `${domain}/.well-known/agent-card.json`,
                 fetchImpl: options.fetchImpl,
@@ -137,17 +148,17 @@ export async function merchantPublish(options) {
             },
         };
     }
-    // ── Step 2: 进程调用 shopping-cli 发布 listings ─────────────────────────
-    // --db 是 shopping-cli 顶层参数，必须在子命令之前（usage: shopping.py [--db DB] {cmd}）。
+    // ── Step 2: 读 shopping-cli 投影 → 直连 catalog 发布 listings ──────────
+    // shopping-cli v3.0 剥离 publish-listings 后，发布面归 kiwi-catalog：
+    // 本步骤读取可发布投影（listings projections list --format json，只读），
+    // 逐条直连 POST /v1/listings/publish（owner token 直传）。--db 是
+    // shopping-cli 顶层参数，必须在子命令之前。
     const spawn = options.spawnImpl ?? spawnSync;
     const args = [
         "--db", options.shoppingCliDb,
         "listings",
-        "publish-listings",
-        "--merchant", merchantId,
-        "--kiwi-catalog-url", options.catalogBaseUrl,
-        "--owner-token-secret", options.ownerTokenSecret,
-        "--owner-agent-id", catalogAgentId,
+        "projections",
+        "--merchant", shoppingMerchant,
         "--format", "json",
     ];
     let result;
@@ -172,31 +183,154 @@ export async function merchantPublish(options) {
     }
     const stdout = String(result.stdout ?? "");
     const stderr = String(result.stderr ?? "");
-    let raw;
+    if (result.status !== 0) {
+        // fail-closed：投影读取失败（含非零退出/输出非 JSON）一律不发布
+        const detail = (stderr !== "" ? stderr.trim() : stdout.trim()).slice(0, 300);
+        return {
+            ok: false,
+            steps: {
+                shopping_cli_compat: compatStep,
+                agent: { ok: true, catalog_agent_id: catalogAgentId },
+                listings: {
+                    ok: false,
+                    errors: [`shopping-cli projections failed: ${detail !== "" ? detail : `exit ${result.status ?? "?"}`}`],
+                },
+            },
+        };
+    }
+    let projections = [];
     try {
-        raw = stdout !== "" ? JSON.parse(stdout) : undefined;
+        const parsed = JSON.parse(stdout);
+        if (parsed.ok === true && Array.isArray(parsed.results)) {
+            projections = parsed.results;
+        }
     }
     catch {
-        raw = undefined;
+        // 非 JSON → fail-closed（不发布，避免漏发）
+        return {
+            ok: false,
+            steps: {
+                shopping_cli_compat: compatStep,
+                agent: { ok: true, catalog_agent_id: catalogAgentId },
+                listings: { ok: false, errors: [`shopping-cli projections 输出非 JSON：${stdout.slice(0, 200)}`] },
+            },
+        };
+    }
+    // 逐条直连 catalog publish（投影是 canonical payload 子集；owner 身份由
+    // 发布方补齐：merchant_id / owner_agent_id / owner_token / handoff 默认）。
+    // owner token：直传优先，否则 HMAC 派生（与 register 一致）。
+    const effectiveOwnerToken = options.ownerToken !== undefined && options.ownerToken !== ""
+        ? options.ownerToken
+        : options.ownerTokenSecret !== undefined
+            ? createHmac("sha256", options.ownerTokenSecret)
+                .update(`kiwi-catalog-owner:${catalogMerchantId}`)
+                .digest("hex")
+            : "";
+    const reportErrors = [];
+    const publishedRefs = [];
+    const skippedRefs = [];
+    for (const projection of projections) {
+        const ref = String(projection.source_product_ref ?? "?");
+        // category 必须非空（catalog contracts.py 要求）——为空则跳过并报告，
+        // 不猜默认值（fail-closed）。
+        const category = projection.category;
+        if (typeof category !== "string" || category.trim() === "") {
+            skippedRefs.push(ref);
+            continue;
+        }
+        // 投影含内部元数据（_provenance 等）——catalog 契约 additionalProperties:
+        // false，发布前剔除 _ 前缀字段（仅 wire 字段进 body）。
+        const wireFields = Object.fromEntries(Object.entries(projection).filter(([key]) => !key.startsWith("_")));
+        const body = {
+            ...wireFields,
+            merchant_id: catalogMerchantId,
+            owner_agent_id: catalogAgentId,
+            owner_token: effectiveOwnerToken,
+            handoff_destination_types: ["external_checkout_url"],
+        };
+        if (typeof body.owner_token !== "string" || body.owner_token === "") {
+            reportErrors.push(`${ref}: no owner token (KIWI_MERCHANT_TOKEN 或 secret 派生)`);
+            continue;
+        }
+        try {
+            const res = await fetchImpl(`${baseUrl}/v1/listings/publish`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(20_000),
+            });
+            const payload = (await res.json());
+            if (res.ok && payload.ok === true) {
+                publishedRefs.push(ref);
+            }
+            else {
+                reportErrors.push(`${ref}: ${payload.error ?? `HTTP ${res.status}`}`);
+            }
+        }
+        catch (err) {
+            reportErrors.push(`${ref}: ${err instanceof Error ? err.message : String(err)}`);
+        }
     }
-    const report = raw ?? {};
-    const published = Array.isArray(report.published) ? report.published.length : 0;
-    const skipped = Array.isArray(report.skipped) ? report.skipped.length : 0;
-    const withdrawn = Array.isArray(report.withdrawn) ? report.withdrawn.length : 0;
-    const reportErrors = Array.isArray(report.errors)
-        ? report.errors.map(String)
-        : [];
-    const spawnFailed = result.status !== 0;
-    if (spawnFailed && reportErrors.length === 0) {
-        const spawnError = result.error;
-        reportErrors.push(spawnError !== undefined
-            ? `shopping-cli spawn failed: ${spawnError.message}`
-            : `shopping-cli exited ${result.status ?? "?"}${stderr !== "" ? `: ${stderr.trim().slice(0, 300)}` : ""}`);
+    // ── Step 2b: reconcile——投影消失的商品 withdraw（data-hub DoD #5）──────
+    // products.active=0 或已删除的商品不再出现在投影里；拉取本 agent 现有
+    // product listings（自查端点，owner_token 经 query），与投影 ref 集合
+    // diff，多出的下架（capability listing 不在投影集合，不处理）。服务端
+    // 对已 WITHDRAWN 幂等返回；SUSPENDED 的 listing 也允许商家 withdraw。
+    const projectedRefs = new Set(projections.map((p) => String(p.source_product_ref ?? "")).filter((ref) => ref !== ""));
+    const withdrawnRefs = [];
+    try {
+        let cursor;
+        for (;;) {
+            const listUrl = `${baseUrl}/v1/agents/${encodeURIComponent(catalogAgentId)}/listings` +
+                `?owner_token=${encodeURIComponent(effectiveOwnerToken)}&limit=100` +
+                (cursor !== undefined ? `&cursor=${encodeURIComponent(cursor)}` : "");
+            const listRes = await fetchImpl(listUrl, { signal: AbortSignal.timeout(15_000) });
+            const listPayload = (await listRes.json());
+            if (!listRes.ok || listPayload.ok !== true) {
+                reportErrors.push(`withdraw reconcile failed: ${listPayload.error ?? `HTTP ${listRes.status}`}`);
+                break;
+            }
+            for (const rec of listPayload.results ?? []) {
+                // 只 diff product listing：capability listing 不在投影集合，不处理
+                if (String(rec.listing_type ?? "") !== "product")
+                    continue;
+                const ref = String(rec.source_product_ref ?? "");
+                if (ref === "" || projectedRefs.has(ref))
+                    continue;
+                if (String(rec.publication_state ?? "") === "WITHDRAWN")
+                    continue;
+                const listingId = String(rec.listing_id ?? "");
+                if (listingId === "")
+                    continue;
+                try {
+                    const wRes = await fetchImpl(`${baseUrl}/v1/listings/${encodeURIComponent(listingId)}/withdraw`, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({ owner_token: effectiveOwnerToken }),
+                        signal: AbortSignal.timeout(20_000),
+                    });
+                    const wPayload = (await wRes.json());
+                    if (wRes.ok && wPayload.ok === true) {
+                        withdrawnRefs.push(ref);
+                    }
+                    else {
+                        reportErrors.push(`${ref}: withdraw ${wPayload.error ?? `HTTP ${wRes.status}`}`);
+                    }
+                }
+                catch (err) {
+                    reportErrors.push(`${ref}: withdraw ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            const next = listPayload.next_cursor;
+            if (typeof next !== "string" || next === "")
+                break;
+            cursor = next;
+        }
     }
-    if (spawnFailed && raw === undefined && stdout !== "") {
-        reportErrors.push(`shopping-cli 输出非 JSON：${stdout.slice(0, 200)}`);
+    catch (err) {
+        reportErrors.push(`withdraw reconcile failed: ${err instanceof Error ? err.message : String(err)}`);
     }
-    const ok = !spawnFailed && reportErrors.length === 0;
+    const ok = reportErrors.length === 0;
     return {
         ok,
         steps: {
@@ -204,11 +338,13 @@ export async function merchantPublish(options) {
             agent: { ok: true, catalog_agent_id: catalogAgentId },
             listings: {
                 ok,
-                published,
-                skipped,
-                withdrawn,
+                published: publishedRefs.length,
+                skipped: skippedRefs.length,
+                withdrawn: withdrawnRefs.length,
+                published_refs: publishedRefs,
+                skipped_refs: skippedRefs,
+                withdrawn_refs: withdrawnRefs,
                 ...(reportErrors.length > 0 ? { errors: reportErrors } : {}),
-                ...(raw !== undefined ? { raw } : {}),
             },
         },
     };

package/dist/product-publish.js.map

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

package/dist/weixin/channel.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AgentKernel } from "../agent/kernel.js";
+import type { WeixinTimings } from "./types.js";
+export interface WeixinChannelOptions {
+    kernel: AgentKernel;
+    /** iLink base URL（已解析：env > profile > default）。 */
+    apiBaseUrl?: string;
+    credentialsPath: string;
+    syncBufPath: string;
+    /** 配置白名单（配对扫描者自动授权；CLI/env/profile 合并后）。 */
+    allowUsers?: readonly string[];
+    /** 强制重新扫码（丢弃已存凭证）。 */
+    forceRelogin?: boolean;
+    /** 二维码渲染（缺省 stdout 打印）。 */
+    renderQr?: (qr: string[]) => void;
+    /** 状态行输出（缺省 stderr）。 */
+    notice?: (line: string) => void;
+    /** 日志行（缺省 stderr；不落 token/context_token）。 */
+    log?: (line: string) => void;
+    now?: () => string;
+    /** 时序覆盖（测试注入冷却/间隔）。 */
+    timings?: Partial<WeixinTimings>;
+}
+export interface WeixinChannelStatus {
+    loggedIn: boolean;
+    pairedUser: string | undefined;
+    allowCount: number;
+}
+/**
+ * 微信通道：open() 登录或加载凭证，run() 阻塞直到 /quit/致命错误/stop()。
+ * kernel 生命周期归 CLI 所有（对齐 cmdChat：CLI finally 里 kernel.close()）。
+ */
+export declare class WeixinChannel {
+    private readonly kernel;
+    private readonly credentialsPath;
+    private readonly syncBufPath;
+    private readonly allowUsers;
+    private readonly timings;
+    private readonly log;
+    private readonly now;
+    private client;
+    private credentials;
+    /** context_token 缓存（key = user_id；协议要求回复回显）。 */
+    private readonly contextTokens;
+    /** 去重指纹（message_id:text MD5；LRU FIFO 裁剪）。 */
+    private readonly seen;
+    private stopped;
+    private runPromise;
+    private pollAbort;
+    private timers;
+    private noticeFn;
+    constructor(options: WeixinChannelOptions);
+    static open(options: WeixinChannelOptions): Promise<WeixinChannel>;
+    /** 扫码登录并持久化凭证。 */
+    private loginAndSave;
+    get status(): WeixinChannelStatus;
+    /** 阻塞直到 /quit、致命错误或 stop()；返回进程退出码。 */
+    run(): Promise<number>;
+    /** 优雅关闭：置 stopped → abort 在飞长轮询 → 写穿 sync state → 清定时器。 */
+    stop(): Promise<void>;
+    private runLoop;
+    private processMessage;
+    /** 发送消息（失败仅日志，不重试——模型回合昂贵，重试只覆盖轮询层）。 */
+    private trySend;
+    private schedulerTickOnce;
+    private negotiateOnce;
+    /** 转发给所有已授权用户（有 context_token 的优先；无 token 的首次可能不可达）。 */
+    private broadcast;
+    private startTimer;
+    private trimSeen;
+    private trimContextTokens;
+    private sleep;
+}