@harrylabsj/kiwi 0.6.0

package/dist/product-init.d.ts

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * 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.
+ */
+export interface MerchantInitOptions {
+    /** 商家名称（写进 profile 注释与 owner 可读性）。 */
+    merchantName: string;
+    /**
+     * shopping-cli merchant_id —— 身份锚（agent_id/owner_id 同源）。
+     * 缺省从 merchantName 派生（普通商家只需要知道自己名称）；
+     * 显式指定用于对接已有 shopping-cli 商家数据。
+     */
+    merchantId?: string;
+    /** shopping-cli API base URL（Kiwi ↔ shopping-cli 连接）。 */
+    shoppingCliUrl?: string;
+    /** shopping-cli SQLite 路径（连接验证与 publish 用；记录于报告）。 */
+    shoppingCliDb?: string;
+    /** kiwi-catalog base URL（publish/start 用）。 */
+    catalogUrl?: string;
+    /** 私有底价（minor 单位；merchant_policy.min_unit_price_private）。 */
+    floorPriceMinor?: number;
+    /** 自动磋商开关（merchant_policy.auto_negotiate，缺省 false）。 */
+    autoNegotiate?: boolean;
+    /** profile 输出路径（缺省 ./merchant.yaml）。 */
+    outputPath?: string;
+    /** 覆盖已存在的输出文件（缺省拒绝）。 */
+    force?: boolean;
+    /**
+     * shopping-cli 缺失时自动安装（pip install shopping-cli，PyPI 包名定稿）。
+     * 只检测到缺失才执行；安装失败 fail-closed（warning，不假装装好）。
+     * rev1.1 §3.2：Merchant 无需知晓并单独安装数据引擎。
+     */
+    autoInstallShoppingCli?: boolean;
+    modelProvider?: string;
+    modelName?: string;
+    apiKeyEnv?: string;
+    /** 测试注入。 */
+    spawnImpl?: typeof import("node:child_process").spawnSync;
+    fetchImpl?: typeof fetch;
+}
+export interface MerchantInitStep {
+    ok: boolean;
+    detail?: string;
+}
+export interface MerchantInitReport {
+    ok: boolean;
+    profile_path: string;
+    agent_id: string;
+    steps: {
+        shopping_cli_detected: MerchantInitStep;
+        shopping_cli_reachable: MerchantInitStep;
+        profile_written: MerchantInitStep;
+        data_dir_initialized: MerchantInitStep;
+    };
+    warnings: string[];
+}
+/**
+ * 执行 merchant init。fail-closed：profile 写盘失败 → ok:false；
+ * shopping-cli 检测/可达性失败只记 warning（生成不阻塞，但报告可见）。
+ */
+export declare function merchantInit(options: MerchantInitOptions): Promise<MerchantInitReport>;

package/dist/product-init.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+/**
+ * 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 merchant init`（product-strategy rev1.1 §3.2/§19 D1）。
+ *
+ * 首次初始化引导，产出可直接被 `kiwi merchant start` / `kiwi merchant
+ * publish` 使用的 merchant profile：
+ *
+ *   1. shopping-cli 依赖检测（缺失 → warning + 引导提示，不阻塞生成）；
+ *   2. Kiwi ↔ shopping-cli 连接可达性（/health，失败 warning 不阻塞）；
+ *   3. 生成 merchant profile（agent_id = merchant_id —— D2 身份统一，
+ *      publish 无需 --shopping-cli-merchant 映射）；
+ *   4. 初始化数据目录（AgentKernel 的 state/sessions，0700）。
+ *
+ * 身份锚 = shopping-cli merchant_id（数据引擎的 merchant 身份）；profile
+ * 不存任何 secret（token_env 只写环境变量名，与 loadProfile 约定一致）。
+ */
+import { spawnSync } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { existsSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { agentDataDir, ensurePathsForDir } from "./agent/agent-db.js";
+import { RUNTIME_VERSION } from "./config/profile.js";
+import { PROTOCOL_VERSION } from "./negotiation/types.js";
+import { detectShoppingCli } from "./product-cli.js";
+function slugifyMerchantId(name) {
+    const slug = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9\u4e00-\u9fff]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (slug !== "")
+        return slug;
+    return `merchant-${randomBytes(3).toString("hex")}`;
+}
+/**
+ * 执行 merchant init。fail-closed：profile 写盘失败 → ok:false；
+ * shopping-cli 检测/可达性失败只记 warning（生成不阻塞，但报告可见）。
+ */
+export async function merchantInit(options) {
+    const warnings = [];
+    // 商家号缺省从名称派生（用户只需要知道自己的商家名称；显式指定用于
+    // 对接已有 shopping-cli 商家数据）。派生规则：小写 + 空白/特殊字符转
+    // '-'；中文保留；空结果回退随机。
+    const merchantId = options.merchantId !== undefined && options.merchantId.trim() !== ""
+        ? options.merchantId.trim()
+        : slugifyMerchantId(options.merchantName);
+    // ── Step 1: shopping-cli 依赖检测（缺失时按需自动安装）──────────────────
+    let detected = detectShoppingCli(options.spawnImpl);
+    if (!detected.ok && options.autoInstallShoppingCli === true) {
+        const spawn = options.spawnImpl ?? spawnSync;
+        let install;
+        try {
+            install = spawn("pip", ["install", "shopping-cli"], {
+                encoding: "utf-8",
+                timeout: 300_000,
+            });
+        }
+        catch (err) {
+            install = {
+                status: -1,
+                stdout: "",
+                stderr: err instanceof Error ? err.message : String(err),
+            };
+        }
+        if (install.status === 0) {
+            // PATH 可能未刷新：重检测，失败也给明确指引
+            detected = detectShoppingCli(options.spawnImpl);
+            if (detected.ok) {
+                warnings.push("shopping-cli 已自动安装（数据引擎就绪）。");
+            }
+            else {
+                warnings.push("pip install shopping-cli 完成但 `shopping` 命令仍不可用——" +
+                    "可能需要刷新 PATH 或重新打开终端。");
+            }
+        }
+        else {
+            warnings.push(`自动安装失败（pip install shopping-cli 退出 ${install.status ?? "?"}）——` +
+                `请手动安装后重试（${String(install.stderr ?? "").trim().slice(0, 200)}）。`);
+        }
+    }
+    if (!detected.ok) {
+        warnings.push(`shopping-cli 未检测到（${detected.error ?? "?"}）——Kiwi Merchant 需要它；` +
+            "安装已默认自动尝试，可用 `kiwi merchant init --no-install` 跳过自动安装、稍后手动安装。");
+    }
+    // ── Step 2: Kiwi ↔ shopping-cli 连接可达性 ──────────────────────────────
+    const shoppingCliUrl = (options.shoppingCliUrl ?? "http://127.0.0.1:8765").replace(/\/+$/, "");
+    let reachable;
+    try {
+        const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        const response = await fetchImpl(`${shoppingCliUrl}/health`, {
+            signal: AbortSignal.timeout(2_000),
+        });
+        reachable = response.ok
+            ? { ok: true, detail: shoppingCliUrl }
+            : { ok: false, detail: `HTTP ${response.status} from ${shoppingCliUrl}` };
+    }
+    catch (err) {
+        reachable = {
+            ok: false,
+            detail: `${shoppingCliUrl} 不可达：${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!reachable.ok) {
+        warnings.push(`shopping-cli API ${shoppingCliUrl} 不可达——` +
+            "profile 仍会生成，但 `kiwi merchant start` 的磋商/数据工具会 fail-closed。");
+    }
+    // ── Step 3: 生成 merchant profile ───────────────────────────────────────
+    const agentId = merchantId; // D2 身份统一：agent_id = shopping-cli merchant_id
+    const floorPriceMinor = options.floorPriceMinor ?? 0;
+    const profile = {
+        // 由 `kiwi merchant init` 生成（D1）。secret 永不入 profile：token_env
+        // 只写环境变量名（与 loadProfile 约定一致）。
+        runtime_version: RUNTIME_VERSION, // profile schema 版本（与产品版本独立）
+        protocol_version: PROTOCOL_VERSION,
+        agent_id: agentId,
+        role: "merchant",
+        owner_id: merchantId,
+        commerce: {
+            base_url: shoppingCliUrl,
+            token_env: "SHOPPING_MERCHANT_TOKEN",
+            backend: "local_marketplace",
+        },
+        model: {
+            provider: options.modelProvider ?? "deepseek",
+            model: options.modelName ?? "deepseek-v4-flash",
+            api_key_env: options.apiKeyEnv ?? "DEEPSEEK_API_KEY",
+        },
+        runtime: {
+            mode: "once",
+            poll_interval_seconds: 5,
+            turn_timeout_seconds: 90,
+            max_model_steps: 4,
+            max_retries: 2,
+        },
+        merchant_policy: {
+            min_unit_price_private: floorPriceMinor / 100,
+            auto_negotiate: options.autoNegotiate ?? false,
+            human_review_on: ["below_floor", "exceptional_warranty", "suspicious_content"],
+        },
+    };
+    const outputPath = options.outputPath ?? path.resolve("merchant.yaml");
+    let written;
+    if (existsSync(outputPath) && !options.force) {
+        written = { ok: false, detail: `已存在：${outputPath}（用 --force 覆盖）` };
+    }
+    else {
+        try {
+            writeFileSync(outputPath, `# Kiwi Merchant profile — generated by \`kiwi merchant init\` (${new Date().toISOString()})\n` +
+                `# Merchant: ${options.merchantName}\n` +
+                stringifyYaml(profile), { mode: 0o600 });
+            written = { ok: true, detail: outputPath };
+        }
+        catch (err) {
+            written = {
+                ok: false,
+                detail: `写盘失败：${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    // ── Step 4: 初始化数据目录（AgentKernel state/sessions，0700）───────────
+    let dataDirOk = true;
+    let dataDirDetail = "";
+    try {
+        const paths = ensurePathsForDir(agentDataDir(agentId));
+        dataDirDetail = paths.dir;
+    }
+    catch (err) {
+        dataDirOk = false;
+        dataDirDetail = err instanceof Error ? err.message : String(err);
+    }
+    const ok = written.ok && dataDirOk;
+    return {
+        ok,
+        profile_path: outputPath,
+        agent_id: agentId,
+        steps: {
+            shopping_cli_detected: detected.ok
+                ? { ok: true, detail: detected.version ?? "found" }
+                : { ok: false, detail: detected.error ?? "not found" },
+            shopping_cli_reachable: reachable,
+            profile_written: written,
+            data_dir_initialized: dataDirOk ? { ok: true, detail: dataDirDetail } : { ok: false, detail: dataDirDetail },
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=product-init.js.map

package/dist/product-init.js.map

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

package/dist/product-publish.d.ts

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * 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 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 {
+    /** merchant profile（role: merchant；agent_id = catalog merchant_id）。 */
+    profile: AgentProfile;
+    /** kiwi-catalog base URL（缺省由调用方解析 KIWI_CATALOG_URL）。 */
+    catalogBaseUrl: string;
+    /** KIWI_CATALOG_OWNER_TOKEN_SECRET（owner token 派生）。 */
+    ownerTokenSecret: string;
+    /** shopping-cli SQLite 数据库路径（listings publish-listings --db）。 */
+    shoppingCliDb: string;
+    /** shopping-cli 可执行名/路径（缺省 "shopping"）。 */
+    shoppingCliPath?: string;
+    /** shopping-cli 的 merchant_id（缺省 = profile.agent_id；init 统一身份前的显式映射）。 */
+    shoppingCliMerchant?: string;
+    /** catalog 注册域名（缺省 KIWI_CATALOG_DOMAIN / merchant-{agent_id}.local）。 */
+    catalogDomain?: string;
+    /** 测试注入。 */
+    fetchImpl?: typeof fetch;
+    spawnImpl?: typeof spawnSync;
+}
+export interface StepAgent {
+    ok: boolean;
+    catalog_agent_id?: string;
+    error?: string;
+}
+export interface StepListings {
+    ok: boolean;
+    skipped_reason?: string;
+    published?: number;
+    skipped?: number;
+    withdrawn?: number;
+    errors?: string[];
+    raw?: unknown;
+}
+export interface StepCompat {
+    ok: boolean;
+    version?: string;
+    error?: string;
+}
+export interface MerchantPublishReport {
+    ok: boolean;
+    steps: {
+        shopping_cli_compat: StepCompat;
+        agent: StepAgent;
+        listings: StepListings;
+    };
+}
+/**
+ * 执行一次 publish 编排。fail-closed：
+ * - agent 注册失败 → 短路（listings 依赖 owner agent 存在），ok:false；
+ * - listings spawn/报告失败 → ok:false + 错误明细；
+ * - 全成功 → ok:true + 分步计数。
+ */
+export declare function merchantPublish(options: MerchantPublishOptions): Promise<MerchantPublishReport>;

package/dist/product-publish.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+/**
+ * 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 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 { registerCatalogAgent } from "./discovery/catalog-source/register.js";
+import { SHOPPING_CLI_COMPAT, compatRangeText, versionInRange } from "./product-compat.js";
+function safeAgentId(agentId) {
+    return agentId.replace(/[^a-z0-9-]/gi, "-").toLowerCase();
+}
+/**
+ * 执行一次 publish 编排。fail-closed：
+ * - agent 注册失败 → 短路（listings 依赖 owner agent 存在），ok:false；
+ * - listings spawn/报告失败 → ok:false + 错误明细；
+ * - 全成功 → ok:true + 分步计数。
+ */
+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;
+    const domain = options.catalogDomain ??
+        process.env.KIWI_CATALOG_DOMAIN ??
+        `merchant-${safeAgentId(merchantId)}.local`;
+    // ── Step 0: shopping-cli 版本兼容检查（D3 矩阵共同消费，fail-closed）──
+    // 矩阵单一来源 = product-compat.ts；与 `kiwi doctor` 共同消费。
+    const versionSpawn = options.spawnImpl ?? spawnSync;
+    let versionResult;
+    try {
+        versionResult = versionSpawn(options.shoppingCliPath ?? "shopping", ["--version"], {
+            encoding: "utf-8",
+            timeout: 5_000,
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            steps: {
+                shopping_cli_compat: {
+                    ok: false,
+                    error: `shopping-cli 版本检测失败：${err instanceof Error ? err.message : String(err)}`,
+                },
+                agent: { ok: false, error: "shopping-cli 版本不兼容，未执行注册" },
+                listings: { ok: false, skipped_reason: "shopping-cli 版本不兼容" },
+            },
+        };
+    }
+    const versionText = String(versionResult.stdout ?? "").split("\n")[0] ?? "";
+    if (!versionInRange(versionText, SHOPPING_CLI_COMPAT)) {
+        return {
+            ok: false,
+            steps: {
+                shopping_cli_compat: {
+                    ok: false,
+                    version: versionText !== "" ? versionText : undefined,
+                    error: `shopping-cli ${versionText !== "" ? versionText : "版本无法识别"} 超出 Kiwi 支持范围` +
+                        `（${compatRangeText(SHOPPING_CLI_COMPAT)}）`,
+                },
+                agent: { ok: false, error: "shopping-cli 版本不兼容，未执行注册" },
+                listings: { ok: false, skipped_reason: "shopping-cli 版本不兼容" },
+            },
+        };
+    }
+    const compatStep = {
+        ok: true,
+        ...(versionText !== "" ? { version: versionText } : {}),
+    };
+    // ── Step 1: 确认/注册 owner Agent（幂等：先查复用，没有再注册）──────────
+    // 重复 publish 必须是安全操作（rev1.1 §4.5）：kiwi-catalog 一商家一 agent
+    // 约束下二次 register 会 409——先按 merchant 查询已有 agent，有则复用。
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const baseUrl = options.catalogBaseUrl.replace(/\/+$/, "");
+    let catalogAgentId;
+    let agentError;
+    try {
+        const lookupUrl = `${baseUrl}/v1/agent-catalog/merchants/${encodeURIComponent(merchantId)}/agents`;
+        const lookup = await fetchImpl(lookupUrl, { signal: AbortSignal.timeout(15_000) });
+        if (lookup.ok) {
+            const body = (await lookup.json());
+            const existing = body.results?.[0]?.catalog_agent_id;
+            if (typeof existing === "string" && existing !== "") {
+                catalogAgentId = existing;
+            }
+        }
+        // 查询失败（网络/非 2xx）不短路——继续尝试注册；注册失败才报错。
+        if (catalogAgentId === undefined) {
+            const reg = await registerCatalogAgent({
+                catalogBaseUrl: options.catalogBaseUrl,
+                domain,
+                merchantId,
+                ownerTokenSecret: options.ownerTokenSecret,
+                agentCardUrl: `${domain}/.well-known/agent-card.json`,
+                fetchImpl: options.fetchImpl,
+                timeoutMs: 15_000,
+            });
+            catalogAgentId = reg.catalogAgentId;
+        }
+    }
+    catch (err) {
+        agentError = err instanceof Error ? err.message : String(err);
+    }
+    if (agentError !== undefined || catalogAgentId === undefined) {
+        return {
+            ok: false,
+            steps: {
+                shopping_cli_compat: compatStep,
+                agent: { ok: false, error: agentError ?? "catalog register returned no agent id" },
+                listings: { ok: false, skipped_reason: "agent 注册失败（listings 依赖 owner agent）" },
+            },
+        };
+    }
+    // ── Step 2: 进程调用 shopping-cli 发布 listings ─────────────────────────
+    // --db 是 shopping-cli 顶层参数，必须在子命令之前（usage: shopping.py [--db DB] {cmd}）。
+    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,
+        "--format", "json",
+    ];
+    let result;
+    try {
+        result = spawn(options.shoppingCliPath ?? "shopping", args, {
+            encoding: "utf-8",
+            timeout: 60_000,
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            steps: {
+                shopping_cli_compat: compatStep,
+                agent: { ok: true, catalog_agent_id: catalogAgentId },
+                listings: {
+                    ok: false,
+                    errors: [`shopping-cli spawn failed: ${err instanceof Error ? err.message : String(err)}`],
+                },
+            },
+        };
+    }
+    const stdout = String(result.stdout ?? "");
+    const stderr = String(result.stderr ?? "");
+    let raw;
+    try {
+        raw = stdout !== "" ? JSON.parse(stdout) : undefined;
+    }
+    catch {
+        raw = undefined;
+    }
+    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)}` : ""}`);
+    }
+    if (spawnFailed && raw === undefined && stdout !== "") {
+        reportErrors.push(`shopping-cli 输出非 JSON：${stdout.slice(0, 200)}`);
+    }
+    const ok = !spawnFailed && reportErrors.length === 0;
+    return {
+        ok,
+        steps: {
+            shopping_cli_compat: compatStep,
+            agent: { ok: true, catalog_agent_id: catalogAgentId },
+            listings: {
+                ok,
+                published,
+                skipped,
+                withdrawn,
+                ...(reportErrors.length > 0 ? { errors: reportErrors } : {}),
+                ...(raw !== undefined ? { raw } : {}),
+            },
+        },
+    };
+}
+//# sourceMappingURL=product-publish.js.map

package/dist/product-publish.js.map

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

package/dist/protocol/legacy-shopping-negotiation/adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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 { NegotiationEnvelope } from "../../negotiation/domain/envelope.js";
+import type { AcceptedNonbindingAgreement } from "../../negotiation/domain/objects.js";
+import { type NegotiationDecision, type PolicyResult, type SnapshotMessage } from "../../negotiation/types.js";
+import type { LegacyMessageContext, LegacyToKnpContext, TranslationResult } from "./types.js";
+export type { TranslationResult, TranslationNote } from "./types.js";
+/**
+ * shopping.negotiation/0.1 ↔ KNP/1.0 适配器。
+ *
+ * 纯数据转换：任何路径都不执行写入/发送；调用方负责把结果交给对应通道。
+ */
+export declare class LegacyNegotiationAdapter {
+    private readonly opts;
+    constructor(opts?: {
+        now?: () => string;
+        currencyExponentOf?: (currency: string) => number;
+    });
+    private now;
+    private exponentOf;
+    legacyDecisionToEnvelope(decision: NegotiationDecision, ctx: LegacyToKnpContext): TranslationResult<NegotiationEnvelope>;
+    private buildDecisionPayload;
+    envelopeToLegacyDecision(envelope: NegotiationEnvelope): TranslationResult<NegotiationDecision>;
+    legacyMessageToEnvelope(message: SnapshotMessage, ctx: LegacyMessageContext): TranslationResult<NegotiationEnvelope>;
+    envelopeToLegacyMessage(envelope: NegotiationEnvelope): TranslationResult<SnapshotMessage>;
+    agreementToLegacyPolicyResult(agreement: AcceptedNonbindingAgreement): TranslationResult<PolicyResult>;
+    private validateKnpEnvelope;
+    private legacyReplyTarget;
+}