@comchatx/cx-featured-offer 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComChatX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+Have cx guard the Featured Offer (the Buy Box) of your listings. When an offer loses it, cx first fixes what you allowed it to fix, then tells you what it found, what it changed and how. What it cannot fix comes back to you as a plan that names who does what, and where.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## How it works
+
+- Type `/featured-offer-guard` with the ASINs and what you want. cx asks only what your words leave open: how often to look, what it may change without asking you, the price it never goes below, and where to tell you.
+- cx writes your words down as the instruction it follows for each listing, in your files, where you can read and change it.
+- Some causes cx can fix in your store, such as a price above what wins the Featured Offer, or the quantity or handling time of an offer you ship yourself. Others need you or Amazon, such as restocking FBA, an account health appeal or a report through Brand Registry, and come back to you as a plan.
+
+## What it uses
+
+It uses cx-listing-playbook for what decides the Featured Offer, Amazon SP-API for your store, Keepa for the Featured Offer's history where you have it, cx-schedule for the times, and cx-feishu to tell you in Feishu if you want it. Plugins installs the others with it; cx-feishu only if you choose it. Without cx-feishu, cx tells you in the chat.
+
+## What it costs
+
+Checks run only while cx's computer is on, and you pay for that time and for the data each check reads.

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "@comchatx/cx-featured-offer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Has cx guard your listings' Featured Offer (Buy Box): it fixes what you allowed, then reports.",
+  "license": "MIT",
+  "author": "ComChatX",
+  "comchatx": {
+    "about": "让 cx 守住 Buy Box，失去时在你允许的范围内修复，再告诉你。",
+    "description": "让 cx 守住你 listing 的 Featured Offer（Buy Box）。某个报价丢了 Featured Offer 时，cx 会先在你允许的范围内修复，再告诉你它发现了什么、改了什么、怎么改的。修不了的，cx 会给你一份方案，写明谁来做、做什么、去哪里做。\n\n## 怎么用\n\n- 输入 `/featured-offer-guard`，加上 ASIN 和你的要求。你的话里没说清的，cx 才会问：多久看一次、哪些可以不问你就改、价格最低不能低于多少，以及在哪里告诉你。\n- cx 会把你的话记成每个 listing 的执行说明，存在你的文件里，你可以随时查看和修改。\n- 有些原因 cx 能在你的店铺里直接修，比如价格高于能拿到 Featured Offer 的价格，或自发货报价的库存数量、处理时间。另一些需要你或亚马逊处理，比如给 FBA 补货、账户健康申诉、通过品牌备案举报，cx 会把它们写成方案交给你。\n\n## 它会用到\n\n它用 cx-listing-playbook 了解 Featured Offer 由什么决定，用 Amazon SP-API 读取和修改你的店铺，有 Keepa 时用它查看 Featured Offer 的历史，用 cx-schedule 定时，用 cx-feishu 在飞书里通知你。安装时会一并装好这些插件。\n\n## 费用\n\n检查只在 cx 的电脑开机时运行，开机时长和每次检查读取的数据都需要付费。",
+    "mark": {
+      "line": "target"
+    },
+    "section": "extensions",
+    "order": 54,
+    "tryIt": [
+      {
+        "en": "/featured-offer-guard {asin} If it loses the Buy Box, fix it above my floor price, then tell me in Feishu",
+        "zh": "/featured-offer-guard {asin} 失去 Buy Box 时，先在底价以上修复，再通过飞书告诉我。"
+      }
+    ],
+    "needs": [
+      "@comchatx/cx-schedule"
+    ],
+    "builds": [
+      "@comchatx/cx-schedule",
+      {
+        "on": "cx-feishu",
+        "need": "optional"
+      },
+      "cx-listing-playbook",
+      "cx-amazon-sp-api",
+      {
+        "on": "cx-keepa",
+        "need": "optional"
+      }
+    ]
+  },
+  "homepage": "https://github.com/comchatx/cx-featured-offer#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/comchatx/cx-featured-offer.git"
+  },
+  "bugs": "https://github.com/comchatx/cx-featured-offer/issues",
+  "keywords": [
+    "pi-package"
+  ],
+  "type": "module",
+  "pi": {
+    "prompts": [
+      "./prompts"
+    ]
+  },
+  "files": [
+    "prompts"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-coding-agent": "1.1.0",
+    "@types/node": "26.2.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  },
+  "overrides": {
+    "@earendil-works/chord": "1.1.0",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-mcp": "1.1.0",
+    "@earendil-works/pi-tui": "1.1.0",
+    "@earendil-works/pi-codemode": "1.1.0",
+    "@earendil-works/pi-agent-core": "1.1.0",
+    "@earendil-works/pi-telemetry": "1.1.0"
+  }
+}

package/prompts/featured-offer-guard.md

@@ -0,0 +1,11 @@
+---
+description: Have cx guard your listings' Featured Offer (Buy Box) — e.g. /featured-offer-guard <ASIN>,<ASIN> 丢了 Buy Box 先在底价以上修，修完在飞书告诉我
+argument-hint: "<ASINs> <what you want, in your words>"
+---
+Guard the Featured Offer of my listings $1 from my words: ${@:2}
+
+Write my standing instruction for each listing in /tenant/listings/<ASIN>/featured-offer.md, quoting my words: how often to look, what you may change without asking me and the price below which you never go, where to tell me, and when to hand over to me. Ask me only what my words and my files leave open.
+
+Unless my words say otherwise: when an offer loses the Featured Offer, first fix what lies within what I allowed, then tell me what you found, what you changed and how. What you cannot fix comes back to me as a plan that names who does what, and where.
+
+Then set the schedule, and report to me where I said. Where I said Feishu and no cx-feishu skill is listed, cx-feishu is not installed: tell me in this chat instead, each time, and say once that it installs from Plugins.