@itpay/cli 2.1.18 → 2.1.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/dist/src/commands/catalog.js +1 -0
  2. package/dist/src/commands/rail_catalog.js +160 -11
  3. package/dist/src/commands/services.js +289 -71
  4. package/dist/src/commands/skill.js +1 -1
  5. package/dist/src/main.js +54 -19
  6. package/dist/src/render/markdown.js +0 -3
  7. package/dist/src/state/account_auth.js +6 -2
  8. package/dist/src/state/cart_session.js +4 -1
  9. package/dist/src/state/config.js +1 -1
  10. package/dist/src/state/device_authority.js +69 -13
  11. package/dist/src/state/task_journal.js +2 -0
  12. package/docs/agent/buyer/cart-checkout.json +5 -4
  13. package/docs/agent/buyer/catalog-list.json +24 -6
  14. package/docs/agent/buyer/identity-and-sessions.json +15 -10
  15. package/docs/agent/buyer/install-and-setup.json +7 -6
  16. package/docs/agent/buyer/orders-refunds.json +4 -4
  17. package/docs/agent/buyer/payment-flow.json +3 -3
  18. package/docs/agent/buyer/purchased-content.json +17 -3
  19. package/docs/agent/buyer/quickstart.json +18 -11
  20. package/docs/agent/buyer/rail-booking.json +79 -167
  21. package/docs/agent/buyer/rail-fast-checkout.json +21 -43
  22. package/docs/agent/buyer/render-hosts.json +8 -5
  23. package/docs/agent/buyer/service-feedback.json +2 -1
  24. package/docs/cli-reference/agent-types.md +1 -1
  25. package/docs/cli-reference/commands/auth.md +2 -0
  26. package/docs/cli-reference/commands/buy.md +1 -1
  27. package/docs/cli-reference/commands/cart/add.md +1 -1
  28. package/docs/cli-reference/commands/cart/clear.md +1 -1
  29. package/docs/cli-reference/commands/cart/index.md +1 -1
  30. package/docs/cli-reference/commands/cart/next.md +1 -1
  31. package/docs/cli-reference/commands/cart/remove.md +1 -1
  32. package/docs/cli-reference/commands/cart/show.md +1 -1
  33. package/docs/cli-reference/commands/catalog/index.md +1 -1
  34. package/docs/cli-reference/commands/catalog/list.md +1 -1
  35. package/docs/cli-reference/commands/checkout.md +1 -1
  36. package/docs/cli-reference/commands/device.md +4 -2
  37. package/docs/cli-reference/commands/docs/index.md +1 -1
  38. package/docs/cli-reference/commands/docs/list.md +1 -1
  39. package/docs/cli-reference/commands/docs/search.md +1 -1
  40. package/docs/cli-reference/commands/docs/show.md +1 -1
  41. package/docs/cli-reference/commands/install.md +2 -2
  42. package/docs/cli-reference/commands/next.md +1 -1
  43. package/docs/cli-reference/commands/order.md +1 -1
  44. package/docs/cli-reference/commands/pay.md +1 -1
  45. package/docs/cli-reference/commands/readyz.md +1 -1
  46. package/docs/cli-reference/commands/refund/cancel.md +1 -1
  47. package/docs/cli-reference/commands/refund/create.md +1 -1
  48. package/docs/cli-reference/commands/refund/get.md +2 -2
  49. package/docs/cli-reference/commands/refund/index.md +1 -1
  50. package/docs/cli-reference/commands/refund/list.md +1 -1
  51. package/docs/cli-reference/commands/refund/watch.md +1 -1
  52. package/docs/cli-reference/commands/services/action.md +3 -3
  53. package/docs/cli-reference/commands/services/checkout.md +1 -1
  54. package/docs/cli-reference/commands/services/events.md +1 -1
  55. package/docs/cli-reference/commands/services/get.md +1 -1
  56. package/docs/cli-reference/commands/services/index.md +1 -1
  57. package/docs/cli-reference/commands/services/invoke.md +3 -11
  58. package/docs/cli-reference/commands/services/list.md +1 -1
  59. package/docs/cli-reference/commands/services/next.md +12 -10
  60. package/docs/cli-reference/commands/services/page.md +9 -7
  61. package/docs/cli-reference/commands/services/quote.md +1 -1
  62. package/docs/cli-reference/commands/services/read-result.md +8 -8
  63. package/docs/cli-reference/commands/services/run.md +2 -2
  64. package/docs/cli-reference/commands/services/start.md +1 -1
  65. package/docs/cli-reference/conventions.md +2 -2
  66. package/package.json +7 -5
  67. package/skills/itpay/SKILL.md +70 -186
  68. package/docs/reviews/agent-ux-handoff-2026-09-23/IMPLEMENTATION-EVIDENCE.md +0 -174
  69. package/docs/skill-bundle-rollout/01-mcp-authentication.md +0 -134
  70. package/docs/skill-bundle-rollout/02-platform-bundle-repositories.md +0 -210
  71. package/docs/skill-bundle-rollout/03-platform-publishing.md +0 -161
  72. package/docs/skill-bundle-rollout/04-first-wave-platforms.md +0 -70
  73. package/docs/skill-bundle-rollout/05-sync-operations.md +0 -62
  74. package/docs/skill-bundle-rollout/README.md +0 -151
  75. /package/bin/{itp → itp.mjs} +0 -0
package/docs/skill-bundle-rollout/README.md DELETED
@@ -1,151 +0,0 @@
1
- # ItPay 平台 Skill / Plugin 与 CLI Bundle 文档入口
2
-
3
- 状态：current。
4
- Authority：CLI 与平台发布边界入口。
5
- 最后核对：2026-08-10。
6
-
7
- 本目录只管理 CLI 和平台发布合同，不管理 Backend、OAuth Server、Buyer、
8
- Vault 或授权状态机。
9
-
10
- 跨平台 Buyer Vault 读取的权威开发计划在 `itpay-ai/compose`：
11
-
12
- ```text
13
- docs/v3/V3_CROSS_PLATFORM_BUYER_VAULT_READ_IMPLEMENTATION_PLAN.md
14
- ```
15
-
16
- 远程 MCP OAuth 与 Local Device Authority 的权威实现记录在：
17
-
18
- ```text
19
- docs/v3/V3_MCP_OAUTH_AND_LOCAL_DEVICE_AUTH_IMPLEMENTATION_PLAN.md
20
- ```
21
-
22
- ## 文档路由
23
-
24
- | 文件 | 负责内容 |
25
- | --- | --- |
26
- | [01-mcp-authentication.md](./01-mcp-authentication.md) | CLI Device 与远程 MCP OAuth 的边界、Token 保管、CLI/MCP 路由。 |
27
- | [02-platform-bundle-repositories.md](./02-platform-bundle-repositories.md) | 平台独立仓库、bundle、lock、同步 PR 和禁止复制核心代码。 |
28
- | [03-platform-publishing.md](./03-platform-publishing.md) | 平台制作、验证、发布、回滚的通用手册和平台差异。 |
29
- | [04-first-wave-platforms.md](./04-first-wave-platforms.md) | 当前真实平台仓库注册表和发布状态；平台集合只以此文件为准。 |
30
- | [05-sync-operations.md](./05-sync-operations.md) | Bundle 同步 GitHub App、fallback、幂等、事故处理和人工恢复。 |
31
-
32
- ## 当前身份边界
33
-
34
- ```text
35
- 本地 Agent
36
- -> bundled @itpay/cli
37
- -> ~/.itpay-v3 Device Authority
38
- -> exact Agent Instance
39
- -> ItPay Backend
40
-
41
- 云端 Chat 平台
42
- -> 原生 MCP OAuth
43
- -> exact MCP Connection
44
- -> ItPay MCP
45
- -> short workload delegation
46
- -> ItPay Backend
47
- ```
48
-
49
- 两条通道可以关联同一 Buyer 并读取同一 Buyer Vault，但不共享：
50
-
51
- - Device 私钥或 Device Session；
52
- - OAuth Access/Refresh Token；
53
- - Agent Instance 或 MCP Connection；
54
- - 临时 Vault 授权窗口；
55
- - 工件首次揭示授权。
56
-
57
- ## 仓库职责
58
-
59
- ### CLI 仓库
60
-
61
- 负责：
62
-
63
- - `@itpay/cli` 源码；
64
- - Device Authority；
65
- - 命令、参数和标准输出；
66
- - 通用 Agent Type/host renderer；
67
- - bundle 生成与可复现性合同；
68
- - CLI 命令文档和测试。
69
-
70
- 不负责：
71
-
72
- - MCP OAuth Token 保存；
73
- - Buyer/Vault 业务状态机；
74
- - 平台商店 manifest；
75
- - 平台专属业务逻辑。
76
-
77
- ### 平台仓库
78
-
79
- 只负责：
80
-
81
- ```text
82
- manifest / MCP config
83
- 平台专属 Skill 与 CLI/MCP 路由
84
- 精确 CLI bundle（本地平台）
85
- bundle.lock.json
86
- 平台测试、审核和发布材料
87
- ```
88
-
89
- 不复制 CLI 源码，不实现 OAuth/Vault/支付，不在运行时下载 `latest`。
90
-
91
- ## 当前平台集合
92
-
93
- 当前发布面只以
94
- [04-first-wave-platforms.md](./04-first-wave-platforms.md) 为准：
95
-
96
- - ChatGPT + Codex；
97
- - WorkBuddy；
98
- - OpenClaw；
99
- - Kimi Work / Kimi Code；
100
- - Hermes Agent。
101
-
102
- Claude 与 Gemini 是后续支持目标，不在没有真实实现和验收时创建占位仓库或
103
- 写成“首批已实施”。
104
-
105
- ## 一个任务只走一条线路
106
-
107
- ```text
108
- 有持久本地 Shell + bundled CLI + 用户未指定 MCP -> CLI
109
- 纯云端平台 -> MCP
110
- 用户明确指定 MCP -> MCP
111
- 用户明确指定 CLI -> CLI
112
- ```
113
-
114
- 选定后禁止静默 fallback。Device 被吊销不能自动改走 MCP；MCP OAuth 失败
115
- 不能自动创建本地 Device。
116
-
117
- ## CLI 文档先行
118
-
119
- 任何命令变更必须遵守：
120
-
121
- ```text
122
- 先更新 command reference
123
- -> 冻结参数/状态/JSON/instruction/next/recovery
124
- -> 再改代码
125
- -> 自动测试
126
- -> 构建真实 CLI
127
- -> 临时 HOME + 真实 Backend 执行
128
- -> 实际输出逐字段对照文档
129
- ```
130
-
131
- JSON 模式 stdout 只能有一个标准 envelope；不能追加调试、进度或提示文本。
132
-
133
- ## 统一发布门禁
134
-
135
- - npm 精确版本、integrity、source SHA 可验证；
136
- - 平台 bundle 版本等于 `bundle.lock.json`；
137
- - 无全局 CLI、无运行时 npm、离线 smoke 通过；
138
- - Skill/bundle 不含 `.env`、Token、私钥、Device 文件或用户数据；
139
- - 平台原生客户端保管和刷新 OAuth Token；Skill/CLI/模型看不到 Token；
140
- - 同步只开 PR，不自动合并、打 tag 或发布商店；
141
- - 每个平台分别保存实际已发布版本和回滚版本；
142
- - Backend compatibility 返回精确最低 CLI 版本，不指导盲目安装 `latest`。
143
-
144
- ## 当前不做
145
-
146
- - 不为每个平台部署一套 MCP Backend；
147
- - 不建立第二套 Buyer 数据；
148
- - 不把平台账号 ID 当 ItPay Buyer；
149
- - 不为不兼容 OAuth 的平台发明模型可见固定 Token；
150
- - 不为尚未开始的平台创建空仓库；
151
- - 不在这个 CLI 文档目录重复服务端 Schema/API/Owner 设计。
/package/bin/{itp → itp.mjs} RENAMED
File without changes