licell 1.0.5 → 1.0.7

package/README.en.md

@@ -9,7 +9,7 @@ It is not just a bag of cloud commands. It is organized around one primary deliv
 - one main entry: `deploy`
 - one project state file: `.licell/project.json`
 - one set of atomic resource commands: `fn` / `oss` / `dns` / `domain`
-- one agent-facing surface: `--help` / `--output json` / `mcp` / `skills`
+- one agent-facing surface: `catalog` / `--help` / `--output json` / `capability` / `skills`
 
 Default region is `cn-hangzhou`. For agent automation, use a dedicated test account or isolated region instead of sharing a production environment directly. For team sharing, use the team auth distribution workflow described below.
 
@@ -30,6 +30,8 @@ Licell currently covers:
 - custom domains, HTTPS, CDN, DNS
 - ACR / Docker image deployment
 - serverless database and cache helpers
+- ACK / ACS cluster and workload inventory
+- protocol-driven discovery and controlled raw API fallback across 16,242 Alibaba Cloud APIs
 - MCP / skills / JSON output / shared-doc generation for agent automation
 
 ---
@@ -247,6 +249,14 @@ Usage and security guidance:
 
 ## Agent Interfaces
 
+Start every natural-language Alibaba Cloud task with the curated command catalog:
+
+```bash
+licell catalog --output json
+```
+
+If no curated command covers the outcome, continue with `capability products/search/describe`, then follow `execution.preferred`. Raw writes require `--dry-run`, explicit `--yes`, and read-back verification through `nextActions[]`.
+
 ### 1. Structured help
 
 Licell help is designed for both humans and agents.

package/README.md

@@ -521,9 +521,11 @@ licell e2e cleanup <runId>
 
 ### Agent Contract
 
-- 发现命令目录：`licell catalog --output json`。
-- 读取单命令契约：`licell <command> --help --output json`。
-- 真正执行命令：`licell <command> --output json`，并过滤 `@@LICELL_JSON@@` 前缀逐行解析。
+- 始终先发现领域命令：`licell catalog --output json`。
+- 命中领域命令：读取 `licell <command> --help --output json`，再执行该命令。
+- 未命中领域命令：依次执行 `capability products/search/describe --output json`，并读取 `execution.preferred`。
+- raw 写操作必须先 `--dry-run`，再显式 `--yes`，最后按 `nextActions[]` 回读验证。
+- 解析执行结果时，只消费带 `@@LICELL_JSON@@` 前缀的逐行 JSON record。
 - 对 `type=event` 的 record，优先读取稳定字段 `stage` / `action` / `status` / `source` / `terminal`。
 - 对 `type=error` 的 record，优先读取 `nextActions[]` 获取首选补救步骤。
 
@@ -533,6 +535,7 @@ licell e2e cleanup <runId>
 - `licell <command> --help --output json`：读取 `help.kind` / `help.schemaVersion`；当前为 `licell-help@1.0`。
 - `licell catalog --output json`：读取 `kind` / `schemaVersion`；当前为 `licell-agent-command-catalog@1.0`。
 - `licell catalog --output json` 还会显式声明 help schema 与 CLI record schema：`licell-help@1.0` / `licell-cli-record@1.0`。
+- 读取 `catalog.agentWorkflow` 获取“领域命令优先、raw capability 兜底”的自然语言路由契约；只有两层发现都失败，才可判定不支持。
 - Agent 优先读取 `nextActions[]` 作为稳定下一步入口；`recommendedFlow` / `decisionGuide` / `remediation[]` 作为补充语义层。
 - 命令自己的业务结果字段继续读取对应命令 help / catalog 里的 `result`；下面三组 contract 只描述公共 CLI record 包络。
 
@@ -751,20 +754,28 @@ licell e2e cleanup <runId>
 | `licell ecs rm <instanceId>` | 删除（释放）ECS 实例（delete 的别名） | `--region`, `--dry-run`, `--yes` |
 | `licell ecs start <instanceId>` | 启动 ECS 实例 | `--region`, `--dry-run` |
 | `licell ecs stop <instanceId>` | 停止 ECS 实例 | `--region`, `--dry-run`, `--yes` |
+| `licell k8s clusters` | 列出当前地域的 ACK / ACS Kubernetes 集群 | `--region`, `--name` |
+| `licell k8s workloads <cluster>` | 只读查询 ACK / ACS 集群内已部署的工作负载和 Service | `--region`, `--private`, `--request-timeout` |
 
 #### Automation & Tooling
 
 面向 Agent、开发体验与 CLI 生命周期的自动化命令。
 
-- `licell skills init`、`licell onboard`、`licell catalog`、`licell completion` 都基于同一套 CLI 命令目录生成外部表面。
+- `licell skills init`、`licell onboard`、`licell catalog`、`licell capability`、`licell completion` 都基于版本化的本地注册表或 protocol 快照生成外部表面。
 - `licell skills init` / `setup` / `onboard` 写入的是 agent-facing 的 licell skill contract；命令参考与字段细节应继续通过 `catalog` / `--help --output json` 获取。
 - `licell onboard` 默认会同时安装 Codex + Claude 的全局 licell skill contract；当安装目标包含 Codex 时，还会额外安装 `licell-glab` subagent。
+- `licell api invoke` 优先使用 PATH 中的 aliyun；缺失时按固定版本下载并校验后缓存到 `~/.licell/bin`。
 - `licell completion` 的候选命令同样来自共享命令目录。
 
 | 命令 | 说明 | 关键选项 |
 |------|------|----------|
 | `licell doctor` | 诊断本机 licell 登录态、云端权限/目标资源/域名入口、项目配置与部署前置条件 | `--region`, `--component`, `--all-components` |
 | `licell catalog` | 输出共享 CLI 命令目录，供 Agent / 自动化发现命令、选项和结构化契约 | `--root-command`, `--command-key` |
+| `licell api invoke <ref>` | 通过固定版本 aliyun-cli runner 调用 raw API | `--region`, `--params-file`, `--param` |
+| `licell api scaffold <ref>` | 从 raw capability 生成 API 请求模板 | — |
+| `licell capability describe <ref>` | 查看一个 raw capability 的完整 OpenAPI 输入和来源 | — |
+| `licell capability products [query]` | 列出 protocol 快照覆盖的阿里云产品和 capability 数量 | `--limit`, `--offset` |
+| `licell capability search [query]` | 从仓库内阿里云 OpenAPI 快照搜索原始 capability | `--intent`, `--product`, `--action` |
 | `licell ci init github` | 生成 GitHub Actions 的 deploy-only workflow（只调用 licell，不负责编译） | `--apply`, `--force`, `--workflow` |
 | `licell ci init gitlab` | 生成 GitLab CI 的 deploy-only pipeline（只调用 licell，不负责编译） | `--apply`, `--force`, `--pipeline` |
 | `licell onboard` | 全局安装 licell 的 agent-facing skill contract；默认同时安装 Codex 与 Claude | `--agent`, `--force` |