@limecloud/cli 0.8.0 → 0.11.0

package/README.md

@@ -69,7 +69,46 @@ pnpm --filter @limecloud/cli test
 npm pack "./packages/cli" --pack-destination ".dev/releases"
 ```
 
-打包前需要存在 `.dev/releases/`。`prepack` 从 `contracts/openapi/identity.json` 和 `management.json` 生成随包合同、检查工作区版本，从 `contracts/i18n/locales.json` 复制唯一语言登记并检查对应 CLI 消息资源，再复制根 `LICENSE`。分发包仅包含命令入口、实现、公开合同、语言登记和消息、README 与许可证，不包含凭据、研究产物或测试夹具。npm 包的实际发布状态以 npmjs 为准；本仓库的构建与打包步骤不会自动发布。
+打包前需要存在 `.dev/releases/`。`prepack` 从 `contracts/openapi/identity.json` 和 `management.json` 生成随包合同、检查工作区版本，从 `contracts/i18n/locales.json` 复制唯一语言登记并检查对应 CLI 消息资源，再复制根 `LICENSE`；公开知识快照从文档站现有 `docArticles` 清单生成。分发包仅包含命令入口、实现、公开合同、公开知识快照、语言登记和消息、README 与许可证，不包含内部 `docs/`、受限 SOP、凭据、研究产物或测试夹具。npm 包的实际发布状态以 npmjs 为准；本仓库的构建与打包步骤不会自动发布。
+
+维护者可在源码仓库运行`node packages/cli/scripts/product-release.mjs build --output-dir .dev/releases/NEW_CANDIDATE`，把同份CLI归档、各自独立的方法包装及可选Codex本地来源清单交付为新候选，再用`verify DIRECTORY`离线核对。默认要求干净源码；显式`--allow-dirty-candidate`只生成`commit:null`的未发布工作树快照。源码期间变化、目录覆盖、链接、归档/包装改写或来源策略不一致均拒绝；不运行归档代码、发布、安装或修改宿主。完整合同及工具链限制见[26第10.13节](../../docs/26-开放文档与CLI.md#1013-公开方法交付候选的源码与内容核对)。来源证明、线上撤回及真实宿主加载仍待验证，清单/摘要不能代替受信渠道。
+
+## 在当前宿主读取知识
+
+```sh
+limecloud-cli docs list --group guide --limit 5 --format table --fields id,title
+limecloud-cli docs search "平台知识" --locale zh-CN --limit 5
+limecloud-cli docs read platform-knowledge --locale zh-CN
+limecloud-cli docs read platform-knowledge --section map --json
+limecloud-cli docs read platform-task-guides --online
+limecloud-cli docs platform-knowledge
+```
+
+`list`、`search` 默认返回 JSON，每页10条、上限50条；用 `--offset` 接续，结果带总数、截断和下一页位置。另支持 `table`、`csv`、`ndjson` 和 `--fields`，非JSON格式在标准错误说明快照来源。`read` 默认返回带来源元信息的 Markdown，也可 `--json`；`--section` 按稳定章节ID读取，`--revision` 要求精确文章修订，正文变化时停止。简写 `docs ARTICLE` 只返回可信网页URL，不启动浏览器。
+
+默认及 `--offline` 仅读取随包公开快照，不访问网络、配置或凭据。元信息区分正文 `revision`、CLI/内容软件版本、请求和实际语言、回退、更新时间及在线/内置来源；快照不证明线上当前能力。`--online` 显式读取文档部署的公开索引和指定正文；`--docs-origin` 可指定可信HTTPS来源，本地验证仅允许回环HTTP。不发送业务Token/Cookie、不跟随重定向、不持久缓存或失败后静默切换来源。在线关键词检索匹配标题/摘要/章节，内置检索另匹配正文，检索范围明确返回。
+
+公开机器入口按 `https://open.limeai.run/llms.txt` → 语言索引 → 主题索引 → Markdown正文逐层读取。静态站与CLI快照同源；开发构建不会自动更新线上或npm。受限运营SOP与MCP知识适配仍按内部实施计划推进。阅读不安装Skills、不授予业务权限或执行正文中的命令。
+
+`schema`/`api schema`的`_meta.knowledge`列出显式关联的公开指南及来源、语言、精确修订；具体命令如`open client list --help`还提供可复制的读取命令。文章的`related_operations`反向引用正式动作。构建校验operationId，不复制参数和权限。关联始终标记随包离线，不能证明目标部署兼容；补充快照缺失/无效时明确`status:unavailable`并保留有效的本地动作Schema。两个Schema入口默认均不读取配置/凭据或联网。
+
+上述为默认/`--offline`行为。显式`schema METHOD --online`或`api schema OPERATION --online`读取当前配置/目标参数，再无凭据地取得精确Issuer/API的公开合同目录；不读凭据、不自动登录或发业务请求。`_meta.compatibility.status`区分`not-checked/matched/different/absent/unknown`，`_meta.contract_revision`标识逐动作合同，软件号及无关方法变化不直接决定本次结果。目录有效期60秒，无持久缓存或失败换源；知识仍为内置。`ok:true`只表示Schema读取成功，`matched`不表示权限、确认或已执行。目标尚未部署该入口时返回未知。
+
+实际Management写入会在每次显式提交前无凭据核对当前动作，只有`matched`才发送正式Bearer请求。CLI自动携带自身合同计算的`Lime-Action-Contract`，不能手动覆盖；服务端执行时再核对，缺失/多个头返回428、动作变化返回409，均不调用本次领域动作。不同/缺项/未知在本地返回`action_contract_different/absent/unknown`和`write_sent:false`；不会自动升级、登录或重试。`--dry-run`仍离线，显示本地请求头不等于在线准备或确认。单成员组已接通冻结准备/精确确认及原ID恢复，见26第10.11节；其他动作、两个真实任务发行版间恢复、Skills实际更新/加载及完整宿主任务仍待交付。此前超时请求是否提交须沿原Owner核对，不能从这一次合同拒绝推断。详细协议见[26第10.10节](../../docs/26-开放文档与CLI.md#1010-当前management写入合同门禁)。
+
+## 只读登录配置诊断
+
+```sh
+limecloud-cli open space list
+limecloud-cli open application list --space-id space_example
+limecloud-cli diagnose login --space-id space_example --app-id app_example --environment sandbox --format table
+```
+
+使用已登记CLI客户端、精确Issuer/API Origin及`lime:open:read`委托。任务先比较当前公开合同，再通过原Management API读取应用及一页OAuth客户端，复用当前认证/范围与授权，不新增业务端点。需要明确空间、应用和环境；每页默认20、上限50，按返回游标用`--cursor`显式继续，不自动翻页、登录、刷新、开页或修改。目标未部署公开合同发现时报告阻塞，不猜在线兼容。
+
+`ok:true`仅表示生成报告，另判`status:observed/attention/partial/blocked`及`coverage`。`observed`仅表示完整返回列表中存在活跃、含openid和回调地址的客户端配置候选，`login_verified`始终为false；各来源不共享快照，后续页保持部分报告。注册中心不可用与空列表区分，无权及来源失败不泄漏响应正文。
+
+Table按覆盖范围、检查码/说明、应用、本页客户端候选、逐来源原始UTC时间、动作合同比对、独立HTTP观察及下一步分段展示，字段和长说明不裁剪。未读取、来源不可用和可读空页分开说明。下一页以包含准确目标/范围/语言的参数数组给出，不自动执行；后台URL是可选接续入口。窄终端可自然换行；需要按字段处理或交给Agent组织时优先JSON。Table的`--fields`只选择检查列，范围、候选与来源仍保留。CSV/NDJSON每条检查记录也附原应用/客户端、来源、完整性、合同和HTTP观察，可用`--fields`显式投影。此能力不等于真实登录、API/Webhook或完整宿主任务验收。
 
 ## 输出语言
 
@@ -159,7 +198,7 @@ limecloud-cli api GET "/api/v1/open/spaces/YOUR_SPACE_ID/applications"
 limecloud-cli api GET "/api/v1/account/profile"
 ```
 
-领域命令采用 `<service> <resource> <method>`，资源名使用 `snake_case`。当前合同包括 9 项 OAuth/OIDC 操作和 124 项委托管理操作；数量随 PRD、服务实现与公共合同更新。通过 `api list` 和 `schema` 查看当前版本，不以本说明中的数字替代运行时目录。
+领域命令采用 `<service> <resource> <method>`，资源名使用 `snake_case`。当前合同包括 9 项 OAuth/OIDC 操作和 123 项委托管理操作；数量随 PRD、服务实现与公共合同更新。通过 `api list` 和 `schema` 查看当前版本，不以本说明中的数字替代运行时目录。
 
 ```sh
 limecloud-cli schema open.application.create
@@ -291,3 +330,57 @@ JSON 返回统一 Envelope；NDJSON 按记录逐行输出 Envelope；Table 与 C
 本包测试覆盖公开合同完整目录与方法预览、真实 loopback Auth/API 分站 HTTP、表单与 JSON 编码、路径/查询/Header、设备授权及恢复、刷新结果未知防重放、格式化输出、二进制及 JSON stdin、PNG 上传入口、私有存储和凭据隔离。
 
 合同目录与请求预览不代替真实业务验收。正式业务 API、客户端登记和 PRD 场景须由本轮服务实现、数据库专项与部署验收证明；包发布不会自动部署平台。管理 BFF 的浏览器会话及 CSRF 入口保持独立，CLI 只调用公共合同中的路径。ID Token 不作为 CLI 凭据解析，应用需要验证 ID Token 时应使用完整 OIDC 库。
+
+
+## 单成员组的精确变更任务
+
+本次源码支持 `task group prepare/get/execute/receipt/resolve`，实际可用需要匹配的已发布包和服务端部署。当前企业 Owner 须有近期强认证，受控客户端须获准申请 `lime:open:read` 与 `lime:open:write`。
+
+```sh
+limecloud-cli schema open.group_change.prepare
+limecloud-cli open group list --space-id "YOUR_SPACE_ID"
+limecloud-cli task group prepare --space-id "YOUR_SPACE_ID" --data @change.json
+limecloud-cli task group get --space-id "YOUR_SPACE_ID" --preparation-id "ORIGINAL_ID" --format table
+# 核对完整原值、冻结命令、范围、影响和期限后，使用原准备的精确摘要
+limecloud-cli task group execute --space-id "YOUR_SPACE_ID" --preparation-id "ORIGINAL_ID" --confirm "EXACT_DIGEST"
+limecloud-cli task group receipt --space-id "YOUR_SPACE_ID" --preparation-id "ORIGINAL_ID"
+limecloud-cli task group resolve --space-id "YOUR_SPACE_ID" --preparation-id "ORIGINAL_ID"
+```
+
+`change.json` 只接受 `expected_revision`、`reason` 与 `group{id,name,status}`。新组显式使用原修订0，修改取当前原修订；准备冻结五分钟，不写入组变更、执行回执或治理审计。同一操作者在同一企业最多20个未过期准备。
+
+输出完整核对资料及 `preview.confirmation_digest`，任务不接受 `--yes`、字段裁剪或隐式确认，表格不截断完整值。所选凭据文件旁的 `.group-operations/` 私有0600文件只保存原主体/范围/目标、合同/确认摘要、期限和发送尝试标记，不保存凭据、命令、影响、组状态或回执。
+
+恢复引用显式同步文件及目录后才发送，不支持目录同步的文件系统失败关闭；未宣称所有OS/文件系统断电语义已验收。执行前回读原准备；本动作发现与凭据检查通过后，先持久一次尝试标记再发送。标记后重跑execute停止，改查原回执或显式resolve。即使标记后请求尚未发出，也按原ID恢复；本地标记不证明服务端已提交，404亦不能证明未提交。引用缺失时可用get从原Owner回读；切换配置、语言或更新不重置原键/确认，也不自动登录、重试或开页。正式API仍独立重验当前权限、原修订、完整影响及期限；命令可用不等于全部宿主完整适配已验收。
+
+更新CLI时保留所选凭据文件及旁侧原恢复目录。软件号变化本身不要求换准备或重做确认：尚无执行尝试时，通过get核对原值，仍须匹配原动作合同、精确确认和原期限；回读不会续期或产生人的批准。已有尝试或结果未知时，升级后仍只查询receipt或显式resolve。CLI包更新不代表宿主方法已更新或当前会话已加载，不能通过重装、切语言或新准备消除原unknown。
+
+原准备读取遇到断网、403、响应不兼容或原绑定变化时，错误仍附带已核对本地引用的`error.recovery`，保留原操作ID、Issuer/API/Client/企业及原执行合同，只提供get/receipt/resolve参数数组；不自动执行、改写引用或清除尝试标记。提示不是成功、当前授权或安全重试的证明；读取/终结仍可能失败。没有有效原引用时不从无效响应或未知引用格式生成提示，保持原文件并报告待核对，不自动迁移或重新准备。
+
+
+## 可选公开方法候选
+
+源码构建包含只读登录配置诊断和单成员组精确变更两个候选，实际命令须由包含它们的CLI发布包提供；每个包装只含所选方法。默认不安装任何方法，以下命令不读凭据、不联网，也不修改宿主设置。
+
+```sh
+limecloud-cli skills list
+limecloud-cli skills inspect limecloud-login-diagnosis --host codex
+limecloud-cli skills inspect limecloud-login-diagnosis --host skill
+limecloud-cli skills inspect limecloud-member-group --host codex
+# 核对完整文件、版本、来源及所选包装的精确摘要后导出到新普通目录
+limecloud-cli skills export limecloud-login-diagnosis --host codex --output-dir ./review-candidate --digest "EXACT_SHA256_DIGEST"
+```
+
+Codex候选包含根plugin.json及单个Skill；通用包装只含方法与当前全部语言步骤。导出拒绝既有目的目录、符号链接祖先及Agent发现/配置位置，不执行制品脚本。它不安装/启用/更新或加载插件，普通CLI升级也不替换已安装方法。实际原生插件由宿主管理器更新，手动导入的更新Owner需独立确定。上述离线输出明确线上兼容/授权/撤回未评估、独立provenance未评估及会话加载未知；摘要匹配只能证明与当前安装CLI内的候选一致。
+
+研发及产品方法源码只在仓库.agents/skills维护，products.json明确分类和公开文件。dist/skills.json仅携带公开候选，不包含部署/UI研发方法、受限SOP、脚本或凭据；制品发布与真实宿主加载尚待验收。
+
+候选的effect由正式HTTP动作推导：登录诊断为read，成员组为write，完整操作清单及修订绑定制品摘要。该标识只供审阅，不授予权限，也不证明已获确认。成员组方法通过task group在宿主内完成选择、字段修正、完整准备核对、用户对具体准备的明确确认与原结果恢复；存在发送尝试或未知结果后保留原ID，只查询/显式终结，不换键、新准备或改用低层API重试。成员增删、角色和批量不在该方法范围；读取/检查/导出均不自动准备或执行。
+
+需要比较目标部署时，显式执行：
+
+```sh
+limecloud-cli skills inspect limecloud-login-diagnosis --online --issuer https://auth.limeai.run --api-origin https://api.limeai.run
+```
+
+该检查复用公开合同，按所需Origin各取一次，不读取凭据或发送Token/Cookie。输出保留全部正文/摘要，以及每个所需动作的修订、目标、环境、目录期限和matched/different/absent/unknown。只有全部匹配才汇总matched；complete只说明全部目录检查有结论，不表示任务完成。旧部署404、网络/格式/错目标/过期均保留未知原因。软件号与无关动作变化不影响当前比较；不自动安装、更新、执行业务或重试，list/export仍只离线。检查对象是随包候选，独立来源证明、线上撤回、当前授权和宿主已安装/加载的副本仍未评估。